You need to enable JavaScript to run this app. 基于Alamofire在Swift中解码API响应触发Codable keyNotFound错误的求助
优惠活动
大模型
产品
解决方案
定价
更多

基于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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.10 06:15:10