为什么CloudKit SwiftUI项目Xcode真机存数据正常但TestFlight版本失效

问题排查及解决方案 #

核心问题高频原因 #

TestFlight运行对应CloudKit生产环境，和开发环境的权限配置、运行时逻辑执行时序存在差异，你遇到的问题90%以上来自以下几个可直接复现的原因： #

1. CloudKit生产环境Record Type创建权限未开启

CloudKit开发环境默认给所有认证用户开放记录的增删改查权限，但是部署Schema到生产环境时，权限配置不会自动同步，需要手动配置：

• 打开CloudKit控制台，进入生产环境
• 找到Task实体对应的Record Type，切换到「安全」标签
• 确认Authenticated User（或你使用的用户角色）的权限中，「创建」选项已勾选
  编辑、删除功能正常说明已有记录的写权限是开的，唯独创建权限没开是你这个场景的典型特征。

2. 异步延迟创建逻辑导致字段赋值为空

你当前创建任务的逻辑加了0.3秒的异步延迟，同时在延迟闭包外直接关闭了模态框：
Release模式下（TestFlight构建默认是Release），模态框dismiss后相关的属性self.name、self.note会被提前释放/重置，0.3秒后执行创建逻辑时，取到的字段值为空，如果Core Data模型或CloudKit中Task的name字段被设为必填，会直接触发校验失败，记录无法保存。
你当前的save函数仅在控制台打印错误，TestFlight环境下你无法捕获到这个报错，所以会出现无报错但保存失败的情况。
修复方案：去掉不必要的延迟，创建保存完成后再关闭模态框

Button(action: {
    let newTask = Task(context: dataController.managedObjectContext)
    newTask.creationDate = Date()
    newTask.name = self.name
    newTask.notes = self.note
    newTask.isComplete = false
    newTask.project = project
    newTask.id = UUID()
    dataController.save()
    showNewTaskModal = false
})

3. Core Data上下文未设置冲突合并策略

你当前仅开启了自动合并父上下文变更，没有设置冲突合并策略，默认的NSErrorMergePolicy在出现云端/本地数据冲突时会直接抛出错误导致保存失败，你看不到报错所以感知不到。
修复方案：在容器初始化时添加合并策略配置
在loadPersistentStores的回调中增加一行：

container.viewContext.mergePolicy = NSMergeByPropertyObjectTrumpMergePolicy

可以根据业务需求选择其他合并策略，比如NSMergeByPropertyStoreTrumpMergePolicy用云端版本覆盖本地。 #

辅助排查手段 #

如果上述方案无法解决，先给save函数增加错误捕获能力，定位具体报错原因：

func save() {
    if container.viewContext.hasChanges {
        do {
            try container.viewContext.save()
        } catch {
            // 测试阶段可以临时弹框显示错误，正式环境可以写入本地日志
            print(error)
            DispatchQueue.main.async {
                let alert = UIAlertController(title: "保存失败", message: error.localizedDescription, preferredStyle: .alert)
                alert.addAction(.init(title: "确定", style: .default))
                UIApplication.shared.windows.first?.rootViewController?.present(alert, animated: true)
            }
        }
    }
}

安装TestFlight版本复现操作，即可拿到具体的错误码，定位根因。 #

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