iOS 15 致NSPersistentCloudKitContainer同步故障：Tags记录无法下载

根因说明 #

iOS 15 对 NSPersistentCloudKitContainer 的多对多关系同步逻辑做了非公开调整，未显式配置双向关联、跨zone存放关联模型、未开启关系镜像配置的场景下，会出现关联模型仅能上传、无法下行同步的问题，该问题在iOS 14及更早版本不存在。

修复步骤 #

1. 修正Core Data模型关系配置 #

• 确认Tag模型中指向Article的反向多对多关系已正确添加，且双方的关系Inverse选项已互相绑定，不得使用单向多对多关系
• 确认两个模型的多对多关系的Optional属性配置和iOS 14版本完全一致，不得随意修改非可选状态
• 确认关系的删除规则统一设置为Nullify，多对多关系使用级联删除/拒绝删除都会触发同步异常

2. 添加容器同步配置 #

iOS 15 新增了关系同步的镜像开关，需要在容器初始化时显式配置：

let container = NSPersistentCloudKitContainer(name: "你的数据模型名称")
guard let description = container.persistentStoreDescriptions.first else {
    fatalError("无法获取持久化存储配置")
}
// 开启历史追踪和远程变更通知
description.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey)
description.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)

if #available(iOS 15.0, *) {
    let cloudOptions = NSPersistentCloudKitContainerOptions(containerIdentifier: "你的CloudKit容器ID")
    // 未使用共享zone时关闭自动共享，避免同步冲突
    cloudOptions.enableAutomaticZoneSharing = false
    description.cloudKitContainerOptions = cloudOptions
}
container.loadPersistentStores(completionHandler: { (storeDescription, error) in
    if let error = error as NSError? {
        fatalError("持久化存储加载失败: \(error), \(error.userInfo)")
    }
})
container.viewContext.automaticallyMergesChangesFromParent = true

3. 校验CloudKit zone分配 #

• 确认Article和Tag两个模型都分配到了同一个CloudKit zone（默认私有zone或者同一个自定义私有zone），iOS 15及以上版本不支持跨zone的关联关系同步
• 如果使用自定义zone，需要在初始化时显式指定数据库范围：

if #available(iOS 15.0, *) {
    container.persistentStoreDescriptions.forEach { desc in
        desc.cloudKitContainerOptions?.databaseScope = .private
    }
}

4. 修复线上已存在的脏数据 #

如果线上已经存在iOS 15用户上传的未关联Tag数据，可以通过主动触发全量同步修复：

• 应用启动完成后调用 container.viewContext.refreshAllObjects()
• 监听 NSPersistentStoreRemoteChange 通知，收到通知后主动执行一次Tag全量查询，触发Core Data下行同步
• 对本地已存储的Article对象，主动读取其tags属性触发关系懒加载，会自动拉取对应的关联Tag数据

5. 校验模型版本配置 #

• 确认当前使用的Core Data模型版本没有未发布的变更，如果在iOS 15发布后更新过模型，要确保升级为轻量迁移，且没有修改Tag和Article的关联关系命名
• 禁止在模型升级时修改关联关系的名称，否则会导致旧版本上传的关联数据无法被新模型识别

验证方案 #

升级配置后在iOS 15设备上卸载重装应用，首次启动时观察Core Data同步日志，确认Tag数据的CKRecord被正常拉取、关联关系正确绑定；再降级到iOS 14执行相同操作，确认两个系统版本的同步逻辑均正常。

内容的提问来源于stack exchange，提问作者Theo Lampert