基于Alamofire在Swift中解码API响应触发Codable keyNotFound错误的求助
Alamofire 接口JSON解码报错
keyNotFound排查与修复 错误根因
- Swift 自动合成的Codable编解码逻辑,只会识别名为
CodingKeys的内部枚举。原代码中自定义的枚举命名为WalletKeys,完全不会被编解码流程加载,此时系统会默认使用类属性名作为解码键,也就是去JSON里找"publicKey"字段,但实际接口返回的是"public_key",因此触发键值找不到的错误。 - 原自定义枚举本身存在Swift语法错误:
case publicKey = "public_key",行尾的无效逗号、case id行尾漏写逗号,就算枚举名修正,代码也无法正常编译。
修复实现
- 第一步:将自定义编码键的枚举名称修改为系统要求的
CodingKeys,让编解码逻辑能读取到字段映射关系。 - 第二步:修正枚举定义中的语法错误,补全漏写的逗号,移除多余的无效逗号。
- 可选优化:如果项目内所有接口都遵循“JSON返回snake_case、Swift模型用camelCase”的命名规则,可以直接给全局JSON解码器配置键名转换策略,不需要每个模型单独写字段映射。
方案1:手动定义映射关系(兼容特殊字段映射场景)
class Response: Codable { var wallet: Wallet var secrets: [String: String] } class Wallet: Codable { var publicKey: String var name: String var id: String var owner: String var currency: String var metadata: [String: String] // 枚举名必须为CodingKeys,系统自动识别加载 enum CodingKeys: String, CodingKey { case publicKey = "public_key" case name case id case owner case currency case metadata } }
方案2:全局配置解码策略(减少重复代码)
初始化解码器时开启snake_case转camelCase的自动转换,Wallet类可以省略自定义枚举定义:
let decoder = JSONDecoder() // 自动匹配JSON中snake_case格式的字段到Swift的camelCase属性 decoder.keyDecodingStrategy = .convertFromSnakeCase
内容的提问来源于stack exchange,提问作者Randomuser123
相关产品推荐
相关产品推荐

