CoreData+CloudKit记录区共享同步时出现shared database非法操作报错

该报错的核心逻辑是CloudKit共享数据库（shared database）不支持操作两类zone：系统默认zone（_defaultZone）、CoreData私有数据库专用的内置zone com.apple.coredata.cloudkit.zone。你遇到的报错是CoreData镜像逻辑尝试在共享数据库中读取/操作上述不支持的zone元数据触发的，Dashboard的报错也正是因为共享数据库中出现了本不该存在的私有库专用zone。

• 检查持久化存储配置：确认你是否区分了私有数据库、共享数据库对应的NSPersistentStoreDescription配置，共享存储不能使用默认的CoreData内置zone，必须显式指定自定义zoneID。
• 检查共享操作逻辑：确认你发起共享邀请时指定的zone是你自行创建的自定义zone，而非CoreData默认的私有库内置zone，com.apple.coredata.cloudkit.zone出现在共享数据库本身就是异常状态。
• 检查zone操作代码：所有涉及CKDatabaseScope.shared的zone操作，排查是否存在未指定自定义zone、尝试查询默认zone元数据的逻辑，你断点停留的NSCKRecordZoneMetadata方法正是CoreData读取zone元数据的触发点。

1. 严格区分私有、共享存储的配置，共享存储必须显式绑定自定义zone，参考配置代码：

// 私有存储配置（可直接使用CoreData默认zone）
let privateDesc = NSPersistentStoreDescription(url: privateStoreUrl)
privateDesc.cloudKitContainerOptions = NSPersistentCloudKitContainerOptions(containerIdentifier: "你的iCloud容器ID")
privateDesc.cloudKitContainerOptions?.databaseScope = .private

// 共享存储配置（必须显式指定用于共享的自定义zone）
let sharedDesc = NSPersistentStoreDescription(url: sharedStoreUrl)
let sharedCloudOpts = NSPersistentCloudKitContainerOptions(containerIdentifier: "你的iCloud容器ID")
sharedCloudOpts.databaseScope = .shared
sharedCloudOpts.zoneID = CKRecordZone.ID(zoneName: "你自定义的共享zone名", ownerName: CKCurrentUserDefaultName)
sharedDesc.cloudKitContainerOptions = sharedCloudOpts

2. 调整共享发起逻辑，仅共享你自行创建的自定义zone，禁止共享CoreData默认的私有库内置zone。
3. 清理异常测试数据：在测试机1上停止错误共享的CoreData默认zone，删除两端的测试应用数据后重新用自定义zone测试，Dashboard的访问报错会同步消失。

如果不修复该问题，会出现共享数据镜像不稳定、偶发同步丢失的问题，极端场景下会直接触发CoreData栈崩溃。

内容的提问来源于stack exchange，提问作者Reinhard Männer