如何获知Core Data轻量级迁移的开始与完成时机？

迁移时机判断逻辑 #

Core Data的轻量级迁移流程是在loadPersistentStores方法执行过程中同步触发的：

• 迁移开始时机：调用container.loadPersistentStores()方法前即为迁移准备开始的节点，可在此处弹出用户等待提示
• 迁移完成时机：loadPersistentStores的completion回调触发即为迁移结束节点，回调无报错则说明迁移完成、持久化存储已加载就绪，可正常读写数据

你当前首次启动无数据的核心原因是：现有代码直接在lazy属性中同步返回持久化容器，未等待loadPersistentStores的异步回调执行完成，就提前使用viewContext读取数据，首次启动迁移耗时较长时就会读取到空数据，第二次启动迁移已完成，存储加载速度快，因此数据正常显示。

代码修改方案 #

你需要将Core Data的初始化逻辑改为异步回调模式，确保上层业务仅在迁移完成、存储加载成功后再操作数据：

1. 调整CoreDataManager结构 #

final class CoreDataManager {
    static let sharedManager = CoreDataManager()
    var persistentContainer: NSPersistentContainer?
    private init() {} // 私有化初始化方法避免外部实例化
    
    /// 初始化Core Data栈，带完成回调
    func setup(completion: @escaping (Bool, Error?) -> Void) {
        let useCloudSync = UserDefaults.standard.bool(forKey: UserDefaults.Keys.useCloudSync)

        let containerToUse: NSPersistentContainer?
        if useCloudSync {
            containerToUse = NSPersistentCloudKitContainer(name: "appName")
        } else {
            containerToUse = NSPersistentContainer(name: "appName")
        }

        guard let container = containerToUse else {
            fatalError("Hey Listen! Could not get a container!!")
        }

        guard let description = container.persistentStoreDescriptions.first else {
            fatalError("Hey Listen! ###\(#function): Failed to retrieve a persistent store description.")
        }
        
        description.setOption(true as NSNumber, forKey: NSPersistentStoreRemoteChangeNotificationPostOptionKey)
        description.setOption(true as NSNumber, forKey: NSMigratePersistentStoresAutomaticallyOption)
        description.setOption(true as NSNumber, forKey: NSInferMappingModelAutomaticallyOption)
        
        if !useCloudSync {
            description.setOption(true as NSNumber, forKey: NSPersistentHistoryTrackingKey)
        }

        container.loadPersistentStores(completionHandler: { [weak self] (storeDescription, error) in
            guard let self = self else { return }
            if let error = error as NSError? {
                completion(false, error)
                return
            }
            // 迁移完成，配置上下文参数
            container.viewContext.mergePolicy = NSMergeByPropertyObjectTrumpMergePolicy
            container.viewContext.transactionAuthor = appTransactionAuthorName
            container.viewContext.automaticallyMergesChangesFromParent = true        

            NotificationCenter.default.addObserver(
                self, selector: #selector(self.storeRemoteChange(_:)),
                name: .NSPersistentStoreRemoteChange, object: container.persistentStoreCoordinator)
            
            self.persistentContainer = container
            completion(true, nil)
        })
    }
    
    @objc private func storeRemoteChange(_ notification: Notification) {
        // 原有远程变更处理逻辑保持不变
    }
}

2. 调整启动流程调用逻辑 #

在App启动入口（如AppDelegate、RootViewController）先执行初始化，显示等待提示，回调成功后再进入主界面加载数据：

// 启动入口调用示例
// 此处可先显示迁移等待提示
CoreDataManager.sharedManager.setup { [weak self] success, error in
    DispatchQueue.main.async {
        // 隐藏等待提示
        if success {
            // 迁移完成，加载主界面、刷新数据
            self?.loadMainPageAndRefreshData()
        } else {
            // 自定义错误处理逻辑
            print("Core Data初始化失败：\(error!.localizedDescription)")
        }
    }
}

优化建议 #

如果应用数据量较大，可在调用setup方法前，通过NSManagedObjectModel的isConfiguration(withName:compatibleWithStoreMetadata:)方法提前判断是否需要执行迁移，给用户更明确的提示文案。迁移过程中不要执行任何Core Data读写操作，避免出现数据异常。

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