Swift中Async/Await接口响应解码失败问题排查

根据你提供的错误信息和代码，问题核心是解码时在JSON根路径下找不到"id"字段，下面是具体排查和解决步骤：

1. 打印原始响应JSON，明确API返回内容 #

你目前只打印了解码错误，但不知道API实际返回的是什么。修改fetch函数的catch块，添加原始数据打印：

catch {
    print("ERROR DECODING")
    print(error)
    // 新增：打印原始响应JSON
    if let rawJson = String(data: data, encoding: .utf8) {
        print("Raw API Response: \(rawJson)")
    }
    print(error.localizedDescription)
    return nil
}

这一步能直接定位问题：

• 如果返回的是错误信息（比如{"error": "权限不足"}），说明请求本身失败了，不是解码问题
• 如果返回的结构是嵌套的（比如{"order": {"id": "xxx"}}），说明你的模型结构和响应不匹配

2. 校验API响应状态码 #

当前代码忽略了响应状态，即使API返回4xx/5xx错误，你依然会尝试解码。在fetch函数里添加状态码校验：

let (data, response) = try await URLSession.shared.data(for: req)
// 新增：校验状态码
guard let httpResp = response as? HTTPURLResponse, (200...299).contains(httpResp.statusCode) else {
    print("Request failed with status code: \(httpResp.statusCode)")
    if let errJson = String(data: data, encoding: .utf8) {
        print("Error Response: \(errJson)")
    }
    return nil
}

这能帮你快速区分是请求失败还是解码失败。

3. 修正模型与响应结构的匹配问题 #

如果打印后发现响应是嵌套结构（比如{"data": {"id": "xxx"}}），需要调整模型：

struct PrintifyOrderResponse: Codable {
    let data: OrderDetail
}

struct OrderDetail: Codable {
    let id: String
}

如果响应里的字段是大写ID而非小写id，可以通过两种方式解决：

• 手动指定编码键：

struct PrintifyOrderResponse: Codable {
    let id: String
    
    enum CodingKeys: String, CodingKey {
        case id = "ID"
    }
}

• 让解码器忽略大小写：

let decoder = JSONDecoder()
decoder.keyDecodingStrategy = .caseInsensitive // 新增这行
let decoded = try decoder.decode(T.self, from: data)

4. 确认请求参数正确性 #

检查PrintifyRequestType.sendToProduction(id)生成的请求是否和Postman一致：

• 请求方法是不是POST/PUT（提交订单通常不是GET）
• 请求头、认证Token、请求体是否完整
• 路径参数是否正确传递

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