Core Data崩溃报错External data reference can't find underlying file修复求助

问题根因 #

该崩溃由两个核心问题共同触发：

1. 你配置的FileProtectionType.complete规则会在设备锁屏后完全禁止所有对CoreData存储文件的访问，而开启Allows External Storage的属性对应的外置存储文件，会直接继承持久化存储的文件保护等级。App后台驻留时用户触发锁屏，此时后台任务读取图片属性，系统拒绝访问外置文件，CoreData就会抛出找不到底层文件的一致性异常。
2. 全局共用同一个backgroundContext的实现违反CoreData的线程安全规则，NSManagedObjectContext是线程绑定的，多个非主线程并发访问同一个上下文会产生数据竞争、引用失效问题，也会导致外置文件引用读取失败。

排查思路 #

1. 本地复现验证：
   • 使用真机测试（模拟器不支持文件保护机制），在系统设置中开启密码锁屏
   • 启动App写入多张足够大的图片，确保触发CoreData外部存储逻辑
   • 将App切后台后立即按电源键锁屏，等待5分钟后主动触发App的后台任务逻辑，即可复现崩溃
2. 埋点确认：
   在所有读取图片data属性的位置新增日志，打印UIApplication.shared.isProtectedDataAvailable的取值，若崩溃时该值为false即可实锤是文件保护导致的问题
3. 上下文使用检查：
   排查所有后台读写CoreData的代码，确认是否存在多线程同时调用全局backgroundContext、读写操作未同步的场景

修复方案 #

紧急修复（直接解决线上崩溃） #

1. 调整CoreData文件保护等级：
   将FileProtectionType.complete替换为安全等级符合要求、同时支持后台访问的等级，推荐使用FileProtectionType.protectedUntilFirstUserAuthentication（用户首次解锁设备后即可全程访问，兼顾安全性和后台可用性）：

   container.persistentStoreDescriptions.forEach {
        $0.setOption(FileProtectionType.protectedUntilFirstUserAuthentication as NSObject, forKey: NSPersistentStoreFileProtectionKey)
   }
   

2. 读取前增加可用性判断：
   所有读取外部存储属性的位置，先判断数据保护是否可用，不可用时跳过读取操作，等App回到前台后再重试：

   guard UIApplication.shared.isProtectedDataAvailable else {
       // 降级逻辑：返回占位图、或者延后到前台再读取
       return
   }
   // 再执行CoreData图片属性读取逻辑
   

3. 修复上下文线程安全问题：
   废弃当前判断线程返回全局上下文的实现，统一使用CoreData官方提供的线程安全API：

   // 主线程操作统一用viewContext的perform方法
   persistentContainer.viewContext.perform {
       // 执行主线程读写逻辑
   }
   
   // 后台操作统一用performBackgroundTask，系统自动创建独立的后台上下文，线程安全
   persistentContainer.performBackgroundTask { context in
       // 执行后台读写逻辑
   }
   

长期优化方案 #

1. 避免用CoreData存储大文件：将图片直接写入沙盒目录，CoreData仅存储文件的相对路径，自行管理文件的生命周期，可控性远高于CoreData自动外部存储
2. 增加异常捕获：使用OC异常封装工具捕获CoreData抛出的NSInternalInconsistencyException异常，出现问题时执行降级逻辑避免直接崩溃
3. 限制后台读写操作：尽量将大文件读取、大量数据写入这类重操作放到App前台执行，后台仅执行轻量逻辑

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