执行NSBatchInsertRequest后Core Data实体重复问题求助

问题核心原因 #

从代码及描述来看，实体数量翻倍的关键问题集中在后台上下文未持久化变更和手动刷新时机冲突两方面：后台执行批量插入后未保存上下文，导致内存中的变更与后续持久化后的重复加载；同时手动触发列表刷新的时机与上下文合并变更的过程重叠，加剧了重复问题。

修复步骤 #

1. 后台上下文执行批量插入后必须保存 #

批量插入操作完成后，需先保存后台上下文，确保变更写入持久化存储，再合并到主上下文。修改后台上下文的执行逻辑：

await importContext.perform { [weak self] in
    guard let self else { return }
                
    let batchInsertRequest = NSBatchInsertRequest(entity: AudioFile.entity(), objects: objects)
    batchInsertRequest.resultType = .objectIDs
    
    do {
        let result = try importContext.execute(batchInsertRequest) as? NSBatchInsertResult
        let objs = result?.result as? [NSManagedObjectID] ?? []
        // 先保存后台上下文，确保变更持久化
        try importContext.save()
        
        let changes: [AnyHashable: Any] = [NSInsertedObjectIDsKey: objs]
        NSManagedObjectContext.mergeChanges(fromRemoteContextSave: changes, into: [self.moc])
    } catch {
        print("批量插入失败：\(error)")
    }
}

2. 通过上下文通知自动刷新列表 #

手动调用fetchAudioFiles容易和上下文合并变更的过程冲突，改为监听Core Data的上下文变更通知，自动触发列表刷新：

class SongsListViewModel: ObservableObject {
    static let shared = SongsListViewModel() // 修正原代码中的类名笔误
    
    @Published var audioFiles = [AudioFile]()
    private let moc = DataController.shared.container.viewContext
    private var notificationToken: NSObjectProtocol?
    
    init() {
        // 监听主上下文变更通知
        notificationToken = NotificationCenter.default.addObserver(
            forName: NSManagedObjectContext.objectsDidChangeNotification,
            object: moc,
            queue: .main
        ) { [weak self] _ in
            self?.fetchAudioFiles()
        }
    }
    
    deinit {
        if let token = notificationToken {
            NotificationCenter.default.removeObserver(token)
        }
    }
    
    func fetchAudioFiles() {
        let fetchRequest = AudioFile.fetchRequest()
        do {
            self.audioFiles = try moc.fetch(fetchRequest)
        } catch {
            print("获取音频文件失败：\(error)")
        }
    }
}

3. 移除手动触发的刷新逻辑 #

既然已经通过通知自动刷新，就不需要在导入完成后手动调用fetchAudioFiles，删除以下代码：

// await MainActor.run {
//      SongsListViewModel.shared.fetchAudioFiles()
// }

4. 补充实体唯一约束（可选） #

为AudioFile实体添加唯一约束（比如name+fileExtension的组合约束），配合后台上下文的mergePolicy，从根源上防止重复插入：

• 在Core Data模型编辑器中，选中AudioFile实体，添加约束字段并勾选“Unique”
• 确保后台上下文的mergePolicy设置为NSOverwriteMergePolicy或NSMergeByPropertyObjectTrumpMergePolicy

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