如何对超大体积JSON进行部分序列化与分段解析

类型转换返回null的核心原因 #

你待解析的JSON最外层是数组结构（用[]包裹），对应类型为[[String: Any]]，强行转换为[String: Any]自然会匹配失败返回null。

针对20MB、6000余条记录的JSON场景，按推荐优先级排序如下：

方案1：Codable 明确类型解码（性价比最高） #

不要使用JSONSerialization转无类型字典的写法，类型明确的Codable解码性能比字典转换高40%左右，内存占用低50%以上，你的数据规模下解码耗时通常在100ms以内，无明显卡顿。

1. 定义匹配数据结构的模型：

// 对应JSON外层数组内的元素结构
struct PageResponse: Codable {
    let page: Int
    let total: Int
    let data: [RentalItem]
}

// 对应单条房源记录
struct RentalItem: Codable {
    let address: String
    let neighborhood: String
    let zipcode: String
    let latitude: Double
    let longitude: Double
    let bedroom: String
    let bath: String
    let area: String?
    let status: String
    let photos: [String]
    let video: String?
    let description: String
    let new_listing: Int
    let date_available: String
    let open_house: String?
    let price: Int
    let dishwasher: Bool
    let washer_and_dryer: Bool
    let pets_allowed: Bool
    let live_in_super: Bool
    let elevator: Bool
    let url: String
}

2. 直接指定根类型解码，避免中间字典转换：

let decoder = JSONDecoder()
do {
    // 根节点是数组，所以解码目标为[PageResponse].self
    let result = try decoder.decode([PageResponse].self, from: jsonData)
    let listData = result.first?.data ?? []
    // 直接使用解析完成的强类型数据即可
} catch {
    print("解码失败: \(error.localizedDescription)")
}

如果想统一用驼峰命名，可以给decoder设置keyDecodingStrategy = .convertFromSnakeCase，无需手动匹配蛇形字段名。

方案2：流式逐节点解析（超大型JSON/内存敏感场景） #

如果后续JSON体积进一步增大（超过100MB），不想一次性把全量Data加载进内存，可以使用系统原生的流式解析能力，配合InputStream逐块读取JSON内容：

• 解析到data数组内的单个RentalItem节点时，单独截取该节点的二进制数据解码为模型，处理完成后立即释放相关内存
• 这种方案内存峰值可以控制在1MB以内，无论JSON体积多大都不会出现内存溢出，适合超大数据集的边解析边处理场景（比如解析完一条就存本地数据库/追加到列表）

临时修正现有写法的方案 #

如果暂时不想重构为Codable写法，只需要修正类型转换的目标类型即可正常拿到结果：

if let jsonList = try JSONSerialization.jsonObject(with: jsonData) as? [[String: Any]] {
    guard let firstPage = jsonList.first else { return }
    let totalCount = firstPage["total"] as? Int ?? 0
    let rentalList = firstPage["data"] as? [[String: Any]] ?? []
    // 后续处理逻辑
}

该写法性能较差、容易出现类型匹配错误，仅作为临时兼容方案使用，不推荐长期保留。

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