CoreData存储移至AppGroup容器后无法与CloudKit同步的问题

核心错误是CKError 1014: Bad Container，说明CloudKit无法识别或访问指定的容器，结合AppGroup场景，从以下几点逐一排查：

1. 确认CloudKit容器ID的正确性 #

代码中CDConstants.containerName必须是完整的容器ID（格式通常为iCloud.com.yourcompany.yourapp），而非单纯的容器名称。主App之前能正常同步，大概率是依赖了与bundle ID自动匹配的默认容器，但迁移到AppGroup后必须显式指定正确的完整ID，不能省略前缀。

2. 检查主App与Widget的权限配置一致性 #

两者的Entitlements文件必须完全一致：

• 开启iCloud权限并勾选CloudKit选项；
• iCloud Containers列表中添加目标容器ID，确保主App和Widget都包含该条目；
• App Groups中添加相同的组ID（如group.com.yourcompany.yourapp），且Info.plist中com.apple.security.application-groups数组也包含该组ID。

3. 修正PersistentStoreDescription的配置细节 #

确保共享容器的存储描述配置没有遗漏CloudKit关键参数：

let url = AppGroup.group.containerURL.appendingPathComponent(CDConstants.containerNameSQLite)
let description = NSPersistentStoreDescription(url: url)
// 开启历史追踪和远程变更通知
description.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey)
description.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)
// 明确指定完整的CloudKit容器ID
description.cloudKitContainerOptions = NSPersistentCloudKitContainerOptions(
    containerIdentifier: CDConstants.containerName // 必须是完整ID，如iCloud.com.xxx.xxx
)
// 确保自动合并变更
container.viewContext.automaticallyMergesChangesFromParent = true

注意：代码中的inMemory分支会覆盖存储URL，仅用于调试，正式发布前需确保该分支不会被触发。

4. 清理缓存并重新部署 #

• 删除模拟器中的主App和Widget；
• 清理Xcode的Derived Data；
• 重启Xcode和模拟器后重新安装应用；
• 登录Apple开发者后台，确认目标CloudKit容器状态正常（未被禁用，且已完成配置）。

5. 验证Widget的PersistenceController初始化逻辑 #

确保Widget中使用的PersistenceController与主App完全一致：

• 相同的容器ID；
• 相同的AppGroup存储路径；
• 相同的CloudKit配置参数。
  Widget若单独初始化存储，任何配置差异都会导致同步失败。

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