如何解决Xcode中iPhone与Apple Watch的iCloud容器同步失败问题

问题概述 #

使用Xcode开发iOS与Apple Watch应用，基于Core Data + CloudKit实现数据同步，但iPhone端添加的MyItem数据无法同步至Watch端，Watch仅显示"hello"文本。两台物理设备的iCloud功能正常，已完成基础配置但同步失效。

代码实现 #

iOS端ContentView #

struct ContentView: View {
    @Environment(\.managedObjectContext) private var viewContext

    @FetchRequest(
        sortDescriptors: [NSSortDescriptor(keyPath: \MyItem.timestamp, ascending: true)],
        animation: .default)
    private var items: FetchedResults<MyItem>

    var body: some View {
        NavigationView {
            List {
                ForEach(items) { item in
                    NavigationLink {
                        Text("Item at \(item.timestamp!, formatter: itemFormatter)")
                    } label: {
                        Text("\(item.timestamp!, formatter: itemFormatter)")
                    }
                }
                .onDelete(perform: deleteItems)
            }
            .toolbar {
                ToolbarItem(placement: .navigationBarTrailing) {
                    EditButton()
                }
                ToolbarItem {
                    Button(action: addItem) {
                        Label("Add Item", systemImage: "plus")
                    }
                }
            }
            Text("Select an item")
        }
    }
}

iOS应用入口 #

import SwiftUI

@main
struct testingIcloudApp: App {
    let persistenceController = PersistenceController.shared

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(\.managedObjectContext, persistenceController.container.viewContext)
        }
    }
}

Apple Watch端ContentView #

import SwiftUI

struct ContentView: View {
    
    @Environment(\.managedObjectContext) private var viewContext

    @FetchRequest(
        sortDescriptors: [NSSortDescriptor(keyPath: \MyItem.timestamp, ascending: true)],
        animation: .default)
    private var items: FetchedResults<MyItem>
    
    
    var body: some View {
        VStack {
            Text("hello")
            List {
                ForEach(items) { item in
                    NavigationLink {
                        Text("Item at \(item.timestamp!, formatter: itemFormatter)")
                    } label: {
                        Text("\(item.timestamp!, formatter: itemFormatter)")
                    }
                }
            }
        }
        .padding()
    }
...

Apple Watch应用入口 #

import SwiftUI

@main
struct testingAPicloud_Watch_AppApp: App {
    let persistenceController = PersistenceController.shared
    
    var body: some Scene {
        WindowGroup {
            ContentView()
                .environment(\.managedObjectContext, persistenceController.container.viewContext)
        }
    }
}

PersistenceController #

struct PersistenceController {
    static let shared = PersistenceController()

    static var preview: PersistenceController = {
        let result = PersistenceController(inMemory: true)
        let viewContext = result.container.viewContext
        
        let newAlarm = Alarm(context: viewContext)
        newAlarm.on = false
        newAlarm.name = "Demo Alarm"
        newAlarm.hour = 12
        newAlarm.minute = 59
        newAlarm.hm = 12+59
        newAlarm.sound = "Radar"
        newAlarm.gentleWake = true
        
        let newSleep = NewSleep(context: viewContext)
        newSleep.beginDate = Date()
        newSleep.endDate = Date()
        
     
        do {
            try viewContext.save()
        } catch {
            let nsError = error as NSError
            fatalError("Unresolved error \(nsError), \(nsError.userInfo)")
        }
        return result
    }()

    let container: NSPersistentCloudKitContainer

    init(inMemory: Bool = false) {
        container = NSPersistentCloudKitContainer(name: "SMIOS")
        if inMemory {
            container.persistentStoreDescriptions.first!.url = URL(fileURLWithPath: "/dev/null")
        }
        container.loadPersistentStores(completionHandler: { (storeDescription, error) in
            if let error = error as NSError? {
                fatalError("Unresolved error \(error), \(error.userInfo)")
            }
        })
        container.viewContext.automaticallyMergesChangesFromParent = true
        container.viewContext.mergePolicy = NSMergeByPropertyObjectTrumpMergePolicy
    }
}

已完成配置 #

• iOS与Apple Watch应用均在「签名与功能」中开启iCloud与后台模式
• 已在CloudKit Dashboard启用对应数据库

排查与解决方案 #

1. 验证CloudKit容器一致性 #

确保iOS与Watch应用使用完全相同的CloudKit容器ID：

• 检查两个Target的iCloud配置，容器ID需完全匹配（如iCloud.com.yourdomain.SMIOS）
• 若使用默认容器，需保证两个应用的Bundle ID前缀一致（均使用团队ID）

2. 确认Core Data实体配置 #

• 打开Core Data模型文件，检查MyItem实体的「Uses CloudKit」选项是否勾选
• 确保iOS与Watch端共用同一个Core Data模型文件，避免实体定义不一致

3. 完善持久化存储的CloudKit配置 #

修改PersistenceController的init方法，明确开启CloudKit同步：

init(inMemory: Bool = false) {
    container = NSPersistentCloudKitContainer(name: "SMIOS")
    if inMemory {
        container.persistentStoreDescriptions.first!.url = URL(fileURLWithPath: "/dev/null")
    }
    
    // 配置CloudKit同步选项
    guard let description = container.persistentStoreDescriptions.first else {
        fatalError("No persistent store description found")
    }
    description.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)
    // 替换为你的CloudKit容器ID
    description.cloudKitContainerOptions = NSPersistentCloudKitContainerOptions(containerIdentifier: "iCloud.com.yourdomain.SMIOS")
    
    container.loadPersistentStores(completionHandler: { (storeDescription, error) in
        if let error = error as NSError? {
            fatalError("Unresolved error \(error), \(error.userInfo)")
        }
    })
    container.viewContext.automaticallyMergesChangesFromParent = true
    container.viewContext.mergePolicy = NSMergeByPropertyObjectTrumpMergePolicy
    // 启用远程变更监听
    container.startPersistentStoreRemoteChangeMonitoring()
}

4. 确保数据保存触发同步 #

iOS端addItem方法需保证上下文保存后触发同步：

private func addItem() {
    withAnimation {
        let newItem = MyItem(context: viewContext)
        newItem.timestamp = Date()

        do {
            try viewContext.save()
            // 触发CloudKit同步
            container.viewContext.refreshAllObjects()
        } catch {
            let nsError = error as NSError
            fatalError("Unresolved error \(nsError), \(nsError.userInfo)")
        }
    }
}

5. 调试同步状态 #

• 打开Xcode「Debug Navigator」→「Core Data」查看同步进度与错误
• 在Watch端添加日志，检查数据加载情况：

.onAppear {
    print("Watch端items数量：\(items.count)")
}

• 登录CloudKit Dashboard，确认iPhone端数据已上传至云端

6. 设备端设置检查 #

• 两台设备需登录同一个Apple ID，且开启「iCloud Drive」
• 检查Watch的「设置」→「通用」→「后台App刷新」是否开启
• 重启两台设备并重新安装应用测试

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