macOS中addPersistentStoreWithType触发「无法自动保存」错误的原因排查

问题背景 #

你遇到的这个问题——调用addPersistentStoreWithType时弹出「文档APP_NAME无法自动保存，该文件已被其他应用修改」的错误，在High Sierra 10.13.4之后出现，且注释掉该代码就消失，大概率和系统对Core Data持久化存储文件的锁机制变化有关。

核心原因推测 #

在High Sierra更新后，Apple调整了NSPersistentDocument对底层SQLite文件的管理逻辑，尤其是当你通过额外的NSPersistentStoreCoordinator（也就是代码里的migrationPSC）直接打开本地SQLite文件时，会和NSPersistentDocument自身的持久化存储协调器产生文件锁冲突：

• NSPersistentDocument自带的协调器会为了自动保存持续监控文件状态
• 你手动创建的migrationPSC调用addPersistentStoreWithType时，会以读写模式打开同一个SQLite文件，这会触发系统的文件变更检测，让Document误以为文件被外部应用修改，从而抛出自动保存错误
• 之前的系统版本可能对这种多协调器访问同文件的情况容忍度更高，或者锁机制没那么严格

可能的解决方案 #

针对这个问题，你可以尝试以下几种修复方式：

1. 避免创建额外的PersistentStoreCoordinator访问同一文件
   如果你的代码是为了迁移存储，建议直接复用NSPersistentDocument自身的persistentStoreCoordinator，而不是新建一个。比如：

   // 用文档自带的协调器替代手动创建的migrationPSC
   id sourceStore = [self.persistentStoreCoordinator addPersistentStoreWithType:NSSQLiteStoreType 
                                                                   configuration:NULL 
                                                                             URL:localUrl 
                                                                         options:nil 
                                                                           error:&error];
   

   这样能避免多个协调器同时操作同一个文件，消除锁冲突。

2. 为手动创建的协调器添加只读选项
   如果必须使用独立的协调器，尝试以只读模式打开存储，减少锁竞争：

   NSDictionary *options = @{NSReadOnlyPersistentStoreOption: @YES};
   id sourceStore = [migrationPSC addPersistentStoreWithType:NSSQLiteStoreType 
                                               configuration:NULL 
                                                         URL:localUrl 
                                                     options:options 
                                                       error:&error];
   

   只读模式不会持有写锁，也就不会干扰Document的自动保存流程。

3. 暂时禁用自动保存，操作完成后恢复
   在执行addPersistentStoreWithType前后，临时关闭NSPersistentDocument的自动保存：

   // 关闭自动保存
   [self setAutosavingDelay:0];
   [self disableAutosaving];
   
   // 执行你的存储操作
   NSPersistentStoreCoordinator *migrationPSC = [[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:[self getAManagedObjectModel]]; 
   id sourceStore = [migrationPSC addPersistentStoreWithType:NSSQLiteStoreType configuration:NULL URL:localUrl options:nil error:&error];
   
   // 恢复自动保存
   [self enableAutosaving];
   [self setAutosavingDelay:1.0]; // 恢复默认延迟
   

   这种方式能避免在操作过程中文档触发自动保存检测，从而绕过错误提示。

验证建议 #

你可以先测试第一种方案（复用文档自带的协调器），这是最符合NSPersistentDocument设计逻辑的做法。如果必须使用独立协调器，再尝试只读选项或临时禁用自动保存的方式。另外，可以在不同的High Sierra小版本（比如10.13.6）上测试，看看是否是10.13.4特有的问题，也能帮助确认是否是系统层面的变更导致。

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