如何将嵌套复杂JSON映射并保存至Core Data？离线缓存遇难题

我之前也踩过类似的嵌套JSON映射Core Data的坑，尤其是这种5-8层深度还带编码映射的场景，给你分享几个实用的思路和代码技巧，亲测好用！

第一步：先搞定编码映射的快速查找 #

你的relatedPerson里的code对应实际对象ID，直接解析时去Core Data查会拖慢效率，建议先把编码列表转成内存字典，后续解析直接查表：

// 假设已经把relatedPerson的JSON转成了数组
var relatedPersonMap: [Int: String] = [:]
for item in relatedPersonArray {
    guard let code = item["code"] as? Int, let desc = item["description"] as? String else { continue }
    relatedPersonMap[code] = desc
}
// 如果需要持久化编码表，也可以存在UserDefaults或者单独的Core Data实体里

第二步：用Codable做中间模型层，避免硬解析嵌套JSON #

直接在Core Data里硬解析多层嵌套JSON很容易出错，建议先把JSON转成Swift结构体（用Codable），Xcode甚至能帮你自动生成代码（右键JSON内容选「Paste as Codable」）：

// 简化的Person中间模型，根据你实际的JSON结构调整
struct PersonResponse: Codable {
    let id: Int
    let name: String
    let relatedPersonCode: Int?
    // 多层嵌套的字段就逐层定义子结构体
    let contactInfo: ContactInfoResponse?
}

struct ContactInfoResponse: Codable {
    let phone: String
    let address: AddressResponse?
}

struct AddressResponse: Codable {
    let street: String
    let city: String
    // 更多嵌套字段继续往下定义...
}

解析JSON就变得非常简单：

do {
    let jsonData = yourRawJSONString.data(using: .utf8)!
    let personModel = try JSONDecoder().decode(PersonResponse.self, from: jsonData)
    // 接下来把模型转成Core Data对象
} catch {
    print("JSON解析失败：\(error.localizedDescription)")
}

第三步：中间模型转Core Data实体，递归处理嵌套 #

给你的Core Data实体写个扩展方法，专门处理模型到Core Data对象的转换，嵌套字段就递归调用子实体的转换方法：

// 假设你的Core Data实体类叫CDPerson
extension CDPerson {
    static func from(model: PersonResponse, context: NSManagedObjectContext, relatedMap: [Int: String]) -> CDPerson {
        let person = CDPerson(context: context)
        person.id = Int64(model.id)
        person.name = model.name
        // 处理编码映射：直接从字典取对应描述
        if let code = model.relatedPersonCode {
            person.relatedPerson = relatedMap[code]
        }
        // 处理嵌套的联系信息
        if let contactModel = model.contactInfo {
            let contact = CDContactInfo(context: context)
            contact.phone = contactModel.phone
            // 继续处理地址嵌套
            if let addressModel = contactModel.address {
                let address = CDAddress(context: context)
                address.street = addressModel.street
                address.city = addressModel.city
                contact.address = address
            }
            person.contactInfo = contact
        }
        return person
    }
}

第四步：离线缓存的关键注意事项 #

• 批量处理提升性能：如果是大量数据，用context.performBatchUpdates代替单个保存，避免主线程阻塞
• 数据去重：给Core Data实体的ID字段加唯一约束，或者保存前先查询是否已有相同ID的对象，防止重复插入
• 后台线程操作：把解析和保存逻辑放在Core Data的私有队列上下文（privateQueueContext）里，不要在主线程做耗时操作
• 错误兜底：Core Data操作一定要加try-catch，离线模式下要保证缓存数据的完整性，避免部分失败导致整个缓存失效

小技巧：避免硬编码字段名 #

如果JSON字段名和Core Data属性名不一致，用CodingKeys做映射，代码更健壮：

struct PersonResponse: Codable {
    let id: Int
    let fullName: String
    let relatedPersonCode: Int?
    
    enum CodingKeys: String, CodingKey {
        case id
        case fullName = "user_name" // JSON里的key是user_name，模型里用fullName
        case relatedPersonCode = "related_person_code"
    }
}

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