Alamofire responseDecodable解析含数组JSON的Struct配置问题

你的问题核心是包含SITES数组的JSON解析失败，移除后正常，大概率是数组字段的可选性处理不当或JSON格式细节问题，以下是具体排查和修复步骤：

1. 修正数组字段的可选性 #

你的ValidateUser中siteNames声明为非可选的[UserSites]，但如果后端返回的JSON存在以下情况之一，就会导致解析失败：

• SITES字段完全不存在
• SITES字段值为null
• SITES数组为空（部分场景下后端返回格式异常也会触发错误）

将siteNames改为可选数组即可解决：

struct ValidateUser: Decodable{
    let sessionId: String?
    let isAdmin: String?
    let fullName: String?
    let surname: String?
    let employNo: String?
    let siteNames: [UserSites]? // 改为可选类型
    
    enum CodingKeys: String, CodingKey {
        case sessionId  = "SESSIONID"
        case isAdmin    = "ISADMIN"
        case fullName   = "FNAME"
        case surname    = "SNAME"
        case employNo   = "EMPNO"
        case siteNames  = "SITES"
    }
}

如果需要默认空数组而非可选值，可自定义初始化器确保兼容：

struct ValidateUser: Decodable{
    let sessionId: String?
    let isAdmin: String?
    let fullName: String?
    let surname: String?
    let employNo: String?
    let siteNames: [UserSites]
    
    enum CodingKeys: String, CodingKey {
        case sessionId  = "SESSIONID"
        case isAdmin    = "ISADMIN"
        case fullName   = "FNAME"
        case surname    = "SNAME"
        case employNo   = "EMPNO"
        case siteNames  = "SITES"
    }
    
    init(from decoder: Decoder) throws {
        let container = try decoder.container(keyedBy: CodingKeys.self)
        sessionId = try container.decodeIfPresent(String.self, forKey: .sessionId)
        isAdmin = try container.decodeIfPresent(String.self, forKey: .isAdmin)
        fullName = try container.decodeIfPresent(String.self, forKey: .fullName)
        surname = try container.decodeIfPresent(String.self, forKey: .surname)
        employNo = try container.decodeIfPresent(String.self, forKey: .employNo)
        siteNames = try container.decodeIfPresent([UserSites].self, forKey: .siteNames) ?? []
    }
}

2. 验证UserSites的解析正确性 #

你的UserSites结构本身配置正确，可通过单独解析SITES数组验证：

let testSitesData = """
[
    {
        "NAME": "MTN-ALICE LANE",
        "WEBSITEAPPID": "SiteGUID"
    }
]
""".data(using: .utf8)!

do {
    let sites = try JSONDecoder().decode([UserSites].self, from: testSitesData)
    print(sites)
} catch {
    print("UserSites解析错误：\(error)")
}

如果这一步报错，说明是字段类型或键名不匹配，比如后端返回的WEBSITEAPPID是数字而非字符串。

3. 添加错误捕获定位问题 #

在Alamofire请求中添加错误捕获，明确解析失败的具体原因：

AF.request(targetUrl, method: .post, parameters: params)
    .responseDecodable(of: ValidateUser.self) { response in
        switch response.result {
        case .success(let user):
            print(user)
        case .failure(let error):
            print("解析失败：\(error)")
            if let decodingError = error as? DecodingError {
                print("解码错误详情：\(decodingError)")
            }
        }
    }

通过错误信息可直接定位问题，比如keyNotFound(CodingKeys(stringValue: "SITES", intValue: nil), ...)就说明SITES字段不存在，此时必须将siteNames改为可选类型。

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