Swift JSON解码出现key not found错误问题排查求助

常见问题定位 #

你的代码已经正确完成了life-span到lifespan的字段映射，报错大概率是以下几类问题导致：

• 可选值缺失未处理
  你当前定义的所有属性都是非可选类型：
  • 如果JSON返回的places数组中，某一条数据不存在coordinates字段、或life-span字段
  • 如果life-span结构中某条数据不存在begin或ended字段
    以上场景都会触发key not found错误，把可能缺失、可能为null的属性声明为可选类型（比如var ended: Bool?）即可兼容。
• 解码策略冲突
  如果你给JSONDecoder设置了keyDecodingStrategy为.convertFromSnakeCase，注意该策略仅自动转换下划线分隔的字段名，中划线分隔的字段仍需手动通过CodingKeys映射，你当前的映射写法是正确的，不需要额外调整。
• 新增字段未同步映射
  如果后续你扩展Places结构体的属性（比如新增typeId对应JSON里的type-id），必须手动在CodingKeys枚举中添加对应的映射规则，否则解码逻辑会找不到对应字段。

精准调试方法 #

你可以在解码的do-catch块中捕获DecodingError打印详细错误信息，直接定位缺失的字段：

do {
    let decoder = JSONDecoder()
    let result = try decoder.decode(BrainzData.self, from: jsonData)
} catch let error as DecodingError {
    switch error {
    case .keyNotFound(let key, let context):
        print("找不到字段：\(key.stringValue)，路径：\(context.codingPath.map{$0.stringValue})")
    default:
        print("其他解码错误：\(error.localizedDescription)")
    }
}

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