无法将CloudKit数据接入Widgets，请求排查问题原因

核心问题分析 #

• 持久化存储描述配置错误：原代码直接追加新的persistentStoreDescription，导致Core Data容器同时加载默认沙盒和App Group两个存储，CloudKit同步无法正确关联共享容器的存储。
• 缺少CloudKit容器配置：未给持久化存储描述设置NSPersistentCloudKitContainerOptions，Core Data无法启用CloudKit同步功能。
• UserDefaults未使用App Group：storeCurrentTime方法用了默认UserDefaults.standard，Widget无法访问主App存储的该数据，需改用App Group共享的UserDefaults。
• 后台上下文处理不当：processUpdate里对background context的操作冗余，且fatalError会导致Widget崩溃，应替换为温和的错误处理。

修复后的代码 #

import CoreData
import WidgetKit
import UIKit

public class DataController : ObservableObject {
        
    static let shared = DataController()
    let container: NSPersistentCloudKitContainer!
    
    private let appGroupID = "group.com.name.app"
    
    init(){
        container = NSPersistentCloudKitContainer(name: "Stash")
        
        // 配置CloudKit容器选项
        guard let cloudKitContainer = CKContainer(identifier: "iCloud.com.name.app") else {
            fatalError("无法初始化CloudKit容器，请检查容器ID")
        }
        let cloudKitOptions = NSPersistentCloudKitContainerOptions(container: cloudKitContainer)
        
        // 配置共享存储路径
        let storeURL = URL.storeURL(for: appGroupID, database: "Stash")
        let storeDescription = NSPersistentStoreDescription(url: storeURL)
        storeDescription.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)
        storeDescription.cloudKitContainerOptions = cloudKitOptions
        
        // 替换默认的存储描述，确保只加载共享容器的存储
        container.persistentStoreDescriptions = [storeDescription]
        
        container.viewContext.automaticallyMergesChangesFromParent = true
        container.viewContext.mergePolicy = NSMergeByPropertyObjectTrumpMergePolicy
                
        container.loadPersistentStores { description, error in
            if let error = error {
                print("加载持久化存储失败: \(error.localizedDescription)")
            }
        }
        
        NotificationCenter.default.addObserver(self, selector: #selector(self.processUpdate), name: .NSPersistentStoreRemoteChange, object: nil)
    }
    
    func storeCurrentTime() {
        let currentTime = Date.now
        let formatter = DateFormatter()
        formatter.dateFormat = "HH:mm d MMMM"
        
        let currentTimeString = formatter.string(from: currentTime)
        // 使用App Group共享的UserDefaults
        if let sharedDefaults = UserDefaults(suiteName: appGroupID) {
            sharedDefaults.set(currentTimeString, forKey: "loa")
        }
    }
    
    @objc
    func processUpdate(notification : NSNotification) {
        operationQueue.addOperation{
            let context = self.container.newBackgroundContext()
            context.perform {
                do {
                    // 触发数据同步，确保最新数据被加载
                    try context.fetch(Subject.getSubjectFetchRequest())
                    WidgetCenter.shared.reloadAllTimelines()
                } catch {
                    print("获取数据失败: \(error.localizedDescription)")
                }
            }
        }
    }
    
    lazy var operationQueue: OperationQueue = {
       var queue = OperationQueue()
        queue.maxConcurrentOperationCount = 1
        return queue
    }()
}

public extension URL {
    static func storeURL(for appGroup : String, database : String) -> URL {
        guard let fileContainer = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier: appGroup) else {
            fatalError("无法获取App Group容器路径")
        }
        return fileContainer.appendingPathComponent("\(database).sqlite")
    }
}

额外配置检查 #

• App Group权限：确保主App和Widget都已启用相同的App Group ID，在Xcode的Signing & Capabilities中添加App Group并勾选对应分组。
• CloudKit权限：主App和Widget都需添加CloudKit capability，且容器ID与代码中配置的一致。
• Core Data模型配置：确保数据模型的实体已勾选"Uses CloudKit"选项。

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