使用CoreData的BatchInsert插入数据时出现数据缺失问题

使用以下Swift代码向CoreData批量插入大量数据时，对象虽能创建，但存在部分字段缺失、出现nil或错误数据的情况。传入的字典数组数据验证为正确，但检索数据时结果异常。

问题代码 #

let appDelegate = await NSApplication.shared.delegate as! AppDelegate
let context : NSManagedObjectContext = appDelegate.persistentContainer.newBackgroundContext()
let batchInsert = NSBatchInsertRequest(entityName: entityName.rawValue, objects: data)
let result = try? context.execute(batchInsert) as? NSBatchInsertResult

异常现象 #

• 插入后数据不一致，大量字段为nil
• 用于生成插入数据的字典样本中所有字段均有有效值，无空值

排查与解决方案 #

1. 未提交上下文变更

批量插入操作后未调用save()，导致变更未持久化，检索时可能读取到未提交的临时状态。修正代码需添加保存步骤：

Task {
    let appDelegate = await NSApplication.shared.delegate as! AppDelegate
    let context = appDelegate.persistentContainer.newBackgroundContext()
    
    // 后台上下文需在指定线程执行操作
    context.perform {
        do {
            let batchInsert = NSBatchInsertRequest(entityName: entityName.rawValue, objects: data)
            _ = try context.execute(batchInsert)
            try context.save() // 提交上下文变更
        } catch {
            print("批量插入失败：\(error.localizedDescription)")
        }
    }
}

2. 字典键与实体属性不匹配

确保字典的键名与CoreData实体的属性名完全一致（包括大小写、拼写），比如实体属性为userName，字典键不能写成username或User_Name。

3. 数据类型不匹配

核对字典中字段的类型与实体属性类型严格匹配：

• 实体属性为Int时，字典不能传入String类型值
• 实体属性为Date时，字典不能传入日期字符串，需转换为Date类型后再插入

4. 后台上下文线程问题

newBackgroundContext()创建的上下文需通过perform或performAndWait方法执行操作，确保在其关联的后台线程上处理，避免线程冲突导致的数据异常。

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