替换CoreData+CloudKit为仅本地CoreData时持久化存储加载失败如何解决

这个报错的核心原因是NSPersistentCloudKitContainer初始化时会自动给CoreData模型注入CloudKit专属的系统字段、索引和存储元数据，你直接替换为NSPersistentContainer加载原有SQLite存储时，本地解析器无法识别这些CloudKit专属Schema，触发SQL语法错误，原地迁移失败。

根据你所处的开发阶段选对应处理方式即可：

开发调试阶段（不需要保留旧测试数据） #

这个场景处理最简单：

• 直接删除模拟器/测试设备上的旧App，重新编译运行，新生成的本地存储不会带CloudKit相关残留元数据，就能正常加载。
• 不想删App的话，也可以在初始化持久化容器前，先删除应用沙盒Library/Application Support/目录下和你的数据模型同名的.sqlite、.sqlite-shm、.sqlite-wal三个文件，再走初始化逻辑。

正式发版场景（需要兼容老用户本地历史数据） #

绝对不能直接把NSPersistentCloudKitContainer替换成NSPersistentContainer就发版，否则所有升级用户都会触发你遇到的崩溃，需要做过渡兼容：

1. 第一个过渡版本仍然使用NSPersistentCloudKitContainer初始化，但是手动移除所有CloudKit相关配置，同时开启自动轻量迁移，让系统自动清理存储里的CloudKit专属元数据，参考代码：

lazy var persistentContainer: NSPersistentContainer = {
    let container = NSPersistentCloudKitContainer(name: name)
    guard let storeDesc = container.persistentStoreDescriptions.first else {
        fatalError("No persistent store description found")
    }
    // 移除CloudKit配置，断开和iCloud容器的关联
    storeDesc.cloudKitContainerOptions = nil
    // 开启自动轻量迁移，自动清理CloudKit相关的系统表、字段
    storeDesc.setOption(true as NSNumber, forKey: NSMigratePersistentStoresAutomaticallyOption)
    storeDesc.setOption(true as NSNumber, forKey: NSInferMappingModelAutomaticallyOption)

    container.loadPersistentStores { _, error in
        if let error = error {
            fatalError("Unable to load persistent stores: \(error)")
        }
    }
    return container
}()

2. 等这个过渡版本全量覆盖后，后续版本再把容器类替换为纯NSPersistentContainer，就不会出现迁移错误了。

补充说明：如果你的应用已经上线、且不想做版本过渡，也可以在检测到旧存储加载失败时，直接删除旧的SQLite文件重新创建纯本地存储，但这种方式会导致用户本地未同步到云端的历史数据全部丢失，非必要不推荐。

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