iOS与WatchOS数据同步异常：SwiftData未在手表端更新

我正在练习iOS/iPad与WatchOS之间的数据通信，但遇到了数据同步异常问题：在iOS应用中添加或删除Person对象时，WatchOS应用无法同步更新。我有两块Apple Watch，分别通过蓝牙和蜂窝/Wi-Fi连接设备，目前iOS应用中有4个Person数据，但WatchOS应用显示数据库为空。已查阅大量资料仍未解决问题，求排查可能的错误或遗漏。

iOS App 代码实现 #

ContentView.swift #

struct ContentView: View {
    @Environment(\.modelContext) private var modelContext
    
    // 用于展示的人员数组
    @Query(sort: \Person.name, order: .forward) private var people: [Person]
    
    // 添加随机人员
    func addRandomPerson() {
        let names = ["John", "Alice", "Bob", "Charlie", "David", "Emma", "Frank", "Grace", "Hannah", "Isaac"]
        
        // 随机选择名字
        let name = names.randomElement()!
        
        // 生成生日、身高、体重的随机数据
        let randomBirthday = Date(timeIntervalSince1970: TimeInterval.random(in: 315532800..<(315532800 + (10 * 365 * 24 * 60 * 60)))) // 1980-1990年随机日期
        let randomHeight = Double.random(in: 5.5...6.5) // 5.5-6.5英尺随机身高
        let randomWeight = Int.random(in: 170...210) // 170-210磅随机体重
        
        // 创建新人员对象
        let person = Person(name: name,
                            birthday: randomBirthday,
                            height: randomHeight,
                            weight: randomWeight)
        
        // 插入到模型上下文
        modelContext.insert(person)
    }
    
    // 删除人员
    func deletePerson(at offsets: IndexSet) {
        for index in offsets {
            let person = people[index]
            modelContext.delete(person)
        }
    }
    
    var body: some View {
        VStack {
            Button("Add Random Person") {
                addRandomPerson() // 添加随机人员
            }
            .padding()

            List {
                ForEach(people) { person in
                    VStack(alignment: .leading) {
                        Text(person.name)
                            .font(.headline)
                        Text("Birthday: \(person.birthday.formatted(.dateTime.month().day().year()))")
                            .font(.subheadline)
                        Text("Height: \(person.height, specifier: "%.1f")")
                        Text("Weight: \(person.weight)")
                    }
                    .onTapGesture {
                        // 如需编辑功能可在此处理
                    }
                }
                .onDelete(perform: deletePerson)
            }
        }
        .padding()
    }
}

SwiftData.swift #

@Model
class Person {
    var name: String
    var birthday: Date
    var height: Double
    var weight: Int

    init(name: String, birthday: Date, height: Double, weight: Int) {
        self.name = name
        self.birthday = birthday
        self.height = height
        self.weight = weight
    }
}

启动入口（Watch_ConnectionApp.swift） #

@main
struct Watch_ConnectionApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .modelContainer(for: Person.self)
    }
}

Watch App 代码实现 #

ContentView.swift（PersonListView） #

struct PersonListView: View {
    @Query(sort: \Person.name, order: .forward) private var people: [Person]
    
    public init() { }

    var body: some View {
        List(people) { person in
            VStack(alignment: .leading) {
                Text(person.name)
                    .font(.headline)
                Text("Birthday: \(person.birthday.formatted(.dateTime.month().day().year()))")
                    .font(.subheadline)
                Text("Height: \(person.height, specifier: "%.1f")")
                Text("Weight: \(person.weight)")
            }
        }
        .navigationTitle("People")
    }
}

启动入口（Watch_Connection_App_Watch_AppApp.swift） #

@Model
class Person {
    var name: String
    var birthday: Date
    var height: Double
    var weight: Int

    init(name: String, birthday: Date, height: Double, weight: Int) {
        self.name = name
        self.birthday = birthday
        self.height = height
        self.weight = weight
    }
}

@main
struct Watch_Connection_App_Watch_AppApp: App {
    var body: some Scene {
        WindowGroup {
            NavigationView {
                PersonListView()
            }
        }
        .modelContainer(for: Person.self) // 添加SwiftData栈
    }
}

• 重复定义Person模型，未共享数据模型：
  iOS和Watch App各自定义了独立的Person类，即使结构完全一致，SwiftData会将它们视为两个不同的数据模型，无法共享数据。
  解决方法：将Person模型放到**共享的Swift包（Shared Framework）**中，让iOS和Watch App都引用这个共享包的模型类，确保两者使用同一个Person类型。

• 未启用iCloud同步配置：
  SwiftData默认不会自动同步数据到iCloud，需要手动配置iCloud容器并开启Core Data同步（SwiftData基于Core Data）。
  解决步骤：

  1. 在Apple Developer后台为App ID启用iCloud服务，并配置CloudKit容器。
  2. 在Xcode项目的Signing & Capabilities中，为iOS和Watch App添加iCloud能力，勾选CloudKit并选择对应的容器。
  3. 创建ModelContainer时指定iCloud配置：

     let container = try! ModelContainer(for: Person.self, configurations: ModelConfiguration("Person", cloudKitContainerIdentifier: "iCloud.com.yourteam.yourapp"))
     

     在iOS和Watch App的启动代码中使用这个配置好的容器。

• 未设置正确的App Group（本地同步场景）：
  如果使用本地App Group共享数据（仅支持配对设备蓝牙连接场景，蜂窝/Wi-Fi下无效），需：

  1. 在Developer后台为App ID添加App Group权限。
  2. 在Xcode中为iOS和Watch App添加App Groups能力，加入同一个组。
  3. 创建ModelConfiguration时指定存储位置到App Group：

     let appGroupURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: "group.com.yourteam.yourapp")!
     let config = ModelConfiguration(url: appGroupURL.appending(path: "Person.sqlite"))
     let container = try! ModelContainer(for: Person.self, configurations: config)
     

• Watch App未等待同步完成：
  Watch App启动后可能立即查询数据，但此时iCloud同步尚未完成。可通过监听CloudKit同步状态，或依赖@Query的自动刷新特性（需确保模型和容器配置正确）。

• 设备同步权限未开启：
  检查iOS设备的设置 -> [你的名字] -> iCloud，确保当前App的iCloud权限已开启；同时检查Watch的设置 -> [你的名字] -> iCloud，确认App权限正常。

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