Craft CMS 5.x版本中新增站点时全局集和资源的关系字段传播问题解析

在Craft CMS 5.6.9.1版本中，开发人员发现了一个关于多站点环境下全局集(Global Sets)和资源(Assets)传播的重要问题。当管理员在系统中添加新站点时，全局集和资源中已存在的关系型字段（如Entries字段）无法正确传播到新站点，导致这些字段在新站点中显示为空。

问题现象

具体表现为：

1. 在已有站点中创建的全局集或资源包含关系型字段（如关联了其他内容的Entries字段）
2. 当管理员添加新站点后，系统会自动执行"Propagating global sets"队列任务
3. 任务完成后，新站点中的这些关系型字段内容为空，而原始站点中的关系仍然保持
4. 需要手动执行craft resave命令才能修复这一问题

值得注意的是，这个问题仅出现在全局集和资源上，当为已有部分(Existing Section)启用新站点时，关系字段能够正常传播。

技术背景

在Craft CMS的多站点架构中，全局集和资源是可以在多个站点间共享的内容类型。当新站点被添加时，系统会自动将这些内容传播到新站点，确保所有站点都能访问这些共享资源。

关系型字段的传播机制需要特别处理，因为：

1. 关系数据存储在单独的数据库表中
2. 需要确保关系在传播过程中保持一致性
3. 需要考虑字段是否设置为可翻译

问题根源

经过开发团队分析，这个问题源于关系数据在传播过程中的处理逻辑缺陷。具体来说：

1. 系统在传播全局集和资源时，没有正确处理非可翻译关系型字段的传播
2. 传播队列任务完成后，关系数据未能正确关联到新站点的内容实例上
3. 手动执行resave命令时触发了完整的保存流程，从而修复了关系数据

解决方案

Craft CMS团队在5.6.10版本中修复了这一问题。修复方案主要涉及：

1. 改进了全局集和资源传播时的关系数据处理逻辑
2. 确保非可翻译关系型字段能够正确传播到新站点
3. 优化了传播队列任务的处理流程

最佳实践

对于仍在使用受影响版本的用户，建议：

1. 尽快升级到5.6.10或更高版本
2. 如果暂时无法升级，可以在添加新站点后手动执行craft resave命令
3. 在开发环境中测试全局集和资源的传播行为，确保关系数据正确

总结

这个问题的发现和解决体现了Craft CMS团队对多站点环境下数据一致性的重视。全局集和资源作为跨站点共享内容的重要机制，其传播行为的正确性直接影响到多站点项目的稳定性。开发者在处理类似的多站点内容传播问题时，应当特别注意关系型字段的特殊性，确保它们在站点间的传播过程中保持完整性和一致性。