Core Data SQLite文件备份后丢失原存储引用，如何解决？

你遇到的核心问题在于**migratePersistentStore(_:to:options:withType:)的设计本质**——不管用哪个NSPersistentStoreCoordinator调用它，它都会把原存储从所属的协调器中移除，这是苹果文档明确标注的行为。你代码里的origStore来自主应用的persistentStoreCoordinator，调用迁移后主协调器就失去了这个存储，自然导致应用无法正常访问数据。

这个方法本是为存储迁移（比如切换存储类型、迁移到CloudKit）设计的，而非简单的文件备份，用它做备份从一开始就不合适。

正确的Core Data SQLite备份方案 #

备份Core Data的SQLite存储，正确做法是直接复制所有相关文件（Core Data的SQLite会生成.sqlite、.sqlite-wal、.sqlite-shm三个文件，缺任何一个都可能导致备份数据不完整或无法打开），同时要确保复制操作在安全队列中执行，避免文件被Core Data写入操作占用。

下面是修正后的代码，兼顾备份完整性和原存储的安全性：

func shareDatabase() {
    let container = (UIApplication.shared.delegate as! AppDelegate).persistentContainer
    guard let originalStoreURL = container.persistentStoreCoordinator.persistentStores.first?.url else {
        print("无法找到Core Data存储文件")
        return
    }
    
    let fileManager = FileManager.default
    // 备份目录，放在Application Support下的Backup文件夹中
    let backupDirectoryURL = URL(fileURLWithPath: NSHomeDirectory())
        .appendingPathComponent("Library")
        .appendingPathComponent("Application Support")
        .appendingPathComponent("CoreDataBackup")
    
    // 创建备份目录（如果不存在）
    do {
        try fileManager.createDirectory(at: backupDirectoryURL, withIntermediateDirectories: true)
    } catch {
        print("创建备份目录失败: \(error.localizedDescription)")
        return
    }
    
    // 要备份的所有Core Data相关文件：主SQLite文件、WAL日志、共享内存文件
    let filesToBackup = [
        originalStoreURL,
        originalStoreURL.appendingPathExtension("wal"),
        originalStoreURL.appendingPathExtension("shm")
    ]
    
    // 使用Core Data的后台任务队列执行备份，确保文件不被占用
    container.performBackgroundTask { [weak self] backgroundContext in
        guard let self = self else { return }
        
        for fileURL in filesToBackup {
            // 跳过不存在的文件（比如如果没有启用WAL模式，wal和shm可能不存在）
            guard fileManager.fileExists(atPath: fileURL.path) else { continue }
            
            let backupFileURL = backupDirectoryURL.appendingPathComponent(fileURL.lastPathComponent)
            
            // 如果备份文件已存在，先删除
            if fileManager.fileExists(atPath: backupFileURL.path) {
                do {
                    try fileManager.removeItem(at: backupFileURL)
                } catch {
                    print("删除旧备份文件失败: \(error.localizedDescription)")
                    continue
                }
            }
            
            // 复制文件
            do {
                try fileManager.copyItem(at: fileURL, to: backupFileURL)
            } catch {
                print("复制文件失败 \(fileURL.lastPathComponent): \(error.localizedDescription)")
            }
        }
        
        // 回到主线程分享备份的主SQLite文件
        let backupSQLiteURL = backupDirectoryURL.appendingPathComponent(originalStoreURL.lastPathComponent)
        DispatchQueue.main.async {
            let activityVC = UIActivityViewController(activityItems: [backupSQLiteURL], applicationActivities: nil)
            self.present(activityVC, animated: true)
        }
    }
}

关键说明 #

1. 复制所有关联文件：Core Data默认使用WAL（Write-Ahead Logging）模式，-wal文件保存未提交事务，-shm是共享内存文件，必须一起复制才能保证备份的数据库完整可用。
2. 使用performBackgroundTask：这个方法会在Core Data的专用后台队列中执行操作，确保此时没有写入操作占用文件，避免复制过程中出现文件锁定错误。
3. 保留原存储引用：整个过程没有修改主应用的persistentStoreCoordinator和存储引用，应用的正常数据访问不会受到任何影响。

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