Swift项目JSON解码失败求助：无法解析locations.json

一、JSON文件本身问题 #

• 文件名或路径错误：检查locations.json拼写是否完全正确（iOS系统区分文件名大小写），同时在Xcode的Build Phases > Copy Bundle Resources中确认文件已被添加到bundle资源列表。
• JSON格式非法：校验文件语法是否合规，比如是否存在引号不匹配、缺失逗号、数组最后一个元素后多余逗号等问题。示例错误格式：

  [
    {"name": "公园", "lat": 39.9},
    {"name": "车站", "lat": 39.8}, // 此处逗号多余
  ]
  

• 编码格式错误：确保文件采用UTF-8编码，可通过Xcode的File > Info查看并修改编码类型，非UTF-8编码会导致读取失败。

二、LocationModel.swift模型不匹配问题 #

• 属性名不对应：模型属性名必须和JSON中的键完全一致（包括大小写），比如JSON键是address，模型写成addr会直接解码失败。
• 数据类型不匹配：JSON字段类型和模型定义类型必须一致，比如JSON中纬度是数字类型，模型却定义成String；或者JSON中存在可选字段，模型却定义为非可选类型（且该字段在部分JSON对象中缺失）。示例错误代码：

  struct LocationModel: Codable {
      var name: String
      var lat: String // 错误：JSON中lat是Double类型，应改为Double
  }
  

• 未遵守Codable协议：确认LocationModel及其嵌套的所有子模型都遵守Codable协议，否则JSONDecoder无法完成解码。

三、JSONManager.swift读取/解码逻辑问题 #

• Bundle获取错误：在SwiftUI预览或Swift Package环境中，直接用Bundle.main可能获取到错误的bundle。可改用Bundle(for: Self.self)或Bundle.module（Swift Package场景）。错误示例：

  guard let url = Bundle.main.url(forResource: "locations", withExtension: "json") else {
      fatalError("Failed to decode locations.json from bundle")
  }
  

• 未捕获具体解码错误：当前仅抛出通用错误，建议在catch块中打印详细错误信息，定位具体问题：

  do {
      let data = try Data(contentsOf: url)
      let locations = try JSONDecoder().decode([LocationModel].self, from: data)
  } catch {
      print("解码详情：\(error)") // 打印类型不匹配、键缺失等具体错误
      fatalError("Failed to decode locations.json from bundle")
  }
  

• 解码类型错误：确认解码的类型和JSON结构一致，比如JSON是数组，却解码成单个LocationModel实例，或者反之。

四、MapView.swift预览的特殊情况 #

• 预览环境bundle异常：SwiftUI预览偶尔会出现bundle加载问题，可尝试清理项目（Cmd+Shift+K）、重启Xcode，或在预览中显式指定bundle：

  struct MapView_Previews: PreviewProvider {
      static var previews: some View {
          MapView()
              .environment(\.bundle, Bundle(for: MapView_Previews.self))
      }
  }
  

• 同步加载时机问题：如果在视图初始化时同步加载JSON，预览可能还未准备好bundle资源，可改用异步加载，或在预览中直接传入模拟数据替代JSON加载。

内容的提问来源于stack exchange，提问作者Mr.KLD