如何在Widget与App间共享SwiftData @Model？数据同步异常排查

核心问题 #

你的代码存在三个关键问题，导致App与Widget数据无法同步：

1. 未指定共享存储路径：默认ModelContainer初始化会使用App/Widget各自的沙盒存储，而非App Group共享目录，两者操作的是不同数据库文件。
2. 未持久化上下文修改：修改模型后未调用context.save()，变更仅停留在内存中，未写入磁盘。
3. 重复创建ModelContainer：perform方法中两次初始化ModelContainer，不仅冗余，还可能引发数据读写不一致。

修复步骤 #

1. 配置共享ModelContainer #

先定义全局方法创建指向App Group目录的共享容器，确保App和Widget操作同一数据库：

import SwiftData

func createSharedModelContainer() throws -> ModelContainer {
    // 替换为你的App Group ID
    guard let appGroupURL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: "group.com.yourapp.id") else {
        throw NSError(domain: "AppGroupError", code: -1, userInfo: [NSLocalizedDescriptionKey: "无法获取App Group目录"])
    }
    let modelURL = appGroupURL.appending(path: "MyModel.sqlite")
    
    let config = ModelConfiguration(for: MyModel.self, url: modelURL)
    return try ModelContainer(for: MyModel.self, configurations: config)
}

分别在App和Widget中注入这个共享容器：

• App端：

@main
struct MyApp: App {
    let container: ModelContainer
    
    init() {
        do {
            container = try createSharedModelContainer()
        } catch {
            fatalError("初始化ModelContainer失败: \(error)")
        }
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .modelContainer(container)
    }
}

• Widget端：

struct MyWidget: Widget {
    let container: ModelContainer
    
    init() {
        do {
            container = try createSharedModelContainer()
        } catch {
            fatalError("初始化ModelContainer失败: \(error)")
        }
    }
    
    var body: some WidgetConfiguration {
        IntentConfiguration(kind: "MyWidget", intent: ConfigurationIntent.self, provider: Provider()) { entry in
            MyWidgetEntryView(entry: entry)
                .modelContainer(container)
        }
        .configurationDisplayName("My Widget")
        .description("自定义Widget描述")
    }
}

2. 修复Intent的perform方法 #

复用共享容器并显式保存上下文：

@MainActor
func perform() async throws -> some IntentResult {
    let container = try createSharedModelContainer()
    let context = container.mainContext
    
    let myModel = try context.fetch(
        FetchDescriptor<MyModel>(predicate: #Predicate {
            // 你的过滤逻辑
        })
    ).first
    
    myModel?.functionThatModifiesMyModel()
    
    // 持久化变更到磁盘
    try context.save()
    
    return .result()
}

3. 验证App端视图监听 #

你的@Query和@Environment(\.modelContext)代码本身没问题，只要App端注入了共享容器，@Query会自动监听数据变化并刷新视图。

额外验证点 #

• 确认App和Widget的Xcode项目设置中，"Signing & Capabilities"都添加了同一个App Group，ID完全一致。
• 检查App Group目录权限：配置正确的话，系统会自动赋予读写权限，无需额外操作。

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