iOS开发JSON解析问题：如何正确解析景点API返回数据？

一、解析失败的常见原因 #

• 结构不匹配：API返回的features字段实际结构可能和你定义的模型不一致，比如原本以为是Feature对象数组，实际却是嵌套数组、包含null值，或部分Feature元素缺失必填字段。
• 类型定义错误：比如你把features定义为[Feature]，但API返回的是字典嵌套结构，或者存在类型混淆（比如把字符串类型的"123"当成数字类型解析）。
• 命名映射问题：Swift默认用驼峰命名，若API字段是下划线命名（比如feature_id），没设置CodingKeys做映射会导致解析失败。
• 可选值处理失误：如果features数组内的元素有可选字段，但你定义成了非可选类型，一旦API返回null就会触发解析崩溃。

二、快速判断JSON对应数据类型的方法 #

• 打印原始JSON字符串：调用API后先把返回的Data转成字符串打印，直接查看features的真实结构：

  if let jsonString = String(data: responseData, encoding: .utf8) {
      print(jsonString)
  }
  

• 用JSONSerialization验证类型：临时将JSON转成[String: Any]，直接打印features的类型：

  do {
      if let json = try JSONSerialization.jsonObject(with: responseData) as? [String: Any],
         let features = json["features"] {
          print("features实际类型：\(type(of: features))")
      }
  } catch {
      print(error)
  }
  

• 格式化JSON后查看层级：把打印出的JSON字符串用本地文本编辑器或JSON格式化工具整理，清晰确认每个字段的嵌套关系和类型。
• 对照API文档：正规API会明确标注features的类型（比如是否为数组、是否允许为null），直接按文档定义模型。

三、调试解析错误的技巧 #

• 捕获详细错误信息：用do-catch包裹解析代码，错误日志会直接指出哪个字段类型不匹配：

  let decoder = JSONDecoder()
  do {
      let collection = try decoder.decode(FeatureCollection.self, from: responseData)
  } catch {
      print("解析错误详情：\(error)")
  }
  

• 逐步简化模型：先定义只包含features字段的极简模型（比如struct FeatureCollection: Decodable { let features: [Any] }），确认能解析后再逐步细化Feature的结构，排查子字段问题。

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