Swift复杂JSON解码失败求助：加载数据触发Fatal Error

1. 先获取具体错误详情 #

你的自定义fatal error需要输出完整解码错误信息，默认的解码Error会明确指出字段不匹配、类型错误等问题。修改你的Bundle扩展decode方法，把错误详情补全：

extension Bundle {
    func decode<T: Codable>(_ type: T.Type, from file: String) -> T {
        guard let url = self.url(forResource: file, withExtension: nil) else {
            fatalError("找不到文件 \(file)")
        }

        guard let data = try? Data(contentsOf: url) else {
            fatalError("无法读取文件 \(file)")
        }

        let decoder = JSONDecoder()
        // 若JSON含日期字段，按需设置解码策略
        // decoder.dateDecodingStrategy = .iso8601

        do {
            return try decoder.decode(type, from: data)
        } catch {
            // 输出完整错误信息，定位具体问题
            fatalError("解码失败：\(error.localizedDescription)\n完整错误：\(error)")
        }
    }
}

2. 核对JSON与Codable结构体的匹配项 #

• 字段命名：Swift默认驼峰命名，若JSON用下划线命名，要么给结构体添加CodingKeys枚举映射，要么给JSONDecoder设置keyDecodingStrategy = .convertFromSnakeCase
• 可选类型：JSON中可能为null的字段，结构体对应字段必须加?设为可选类型
• 数据类型：确认JSON中的数组/字典/基本类型，与结构体定义完全一致，比如JSON是数组，结构体不能写成单个对象
• 嵌套层级：检查quicktype生成的子结构体，是否与JSON的嵌套结构完全对应，避免层级错位

3. 验证JSON格式合法性 #

把你的JSON内容复制到本地JSON校验工具中检查，确认没有语法错误，比如遗漏逗号、引号不配对、括号不闭合等问题。

4. 检查JSON文件的Bundle配置 #

• 确认JSON文件已添加到Xcode项目，且在「Target Membership」中勾选了当前目标
• 确认文件名拼写完全正确（iOS系统区分文件名大小写）
• 确认文件扩展名为.json，调用decode方法时不要重复添加扩展名

5. 最小化测试定位问题 #

先编写极简结构体，只解码JSON中的一个核心字段，测试是否能成功解码。如果成功，再逐步添加其他字段，定位到具体导致失败的字段。
示例：

// 假设JSON根对象包含"title"字段
struct SimpleTest: Codable {
    let title: String
}

// 调用测试
let testResult = Bundle.main.decode(SimpleTest.self, from: "yourJsonFile.json")

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