Swift4中URLSession结合Decodable实现POST请求失败问题排查

嘿，我之前也踩过一模一样的坑！Postman能正常拿到响应，但Swift的JSONDecoder就是报错，大概率是模型结构和返回JSON不匹配，或者是一些容易忽略的细节没处理对。咱们一步步来解决：

第一步：先确认你的Swift模型和服务器JSON完全对应 #

你给的Postman响应示例里，有几个很容易踩坑的点：

{
"error": "false",
"message": "downloaded",
"UserInfo": {
"id": 5,
"email": "abc@hotmail.com",
"lastname": "Bence",
"name": "xxx"
}
}

重点注意这两个细节： #

1. error是字符串类型：JSON里是"false"（字符串），不是布尔值false！很多人会把Swift模型里的error定义成Bool，这直接会导致解码失败。
2. 键名大小写差异：JSON里的UserInfo首字母大写，Swift里如果用驼峰命名userInfo，必须通过CodingKeys来映射。

对应的正确Swift Codable模型应该是这样：

// 用户信息子模型
struct UserInfo: Codable {
    let id: Int
    let email: String
    let lastname: String
    let name: String // 如果这个字段可能为空，要改成`String?`
}

// 顶层响应模型
struct UserResponse: Codable {
    let error: String
    let message: String
    let userInfo: UserInfo
    
    // 映射JSON里的大写键名
    enum CodingKeys: String, CodingKey {
        case error, message
        case userInfo = "UserInfo"
    }
}

第二步：检查你的URLSession请求细节 #

确保请求的参数编码、请求头都和Postman一致，比如：

func fetchUserDetails(email: String, password: String) {
    guard let apiUrl = URL(string: "你的API接口地址") else {
        print("无效的API地址")
        return
    }
    
    var request = URLRequest(url: apiUrl)
    request.httpMethod = "POST"
    // 必须设置Content-Type为application/json，和Postman一致
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
    
    // 构造POST参数
    let params: [String: Any] = [
        "email": email,
        "password": password
    ]
    
    // 把参数编码成JSON数据
    do {
        request.httpBody = try JSONSerialization.data(withJSONObject: params, options: [])
    } catch {
        print("参数编码失败：\(error.localizedDescription)")
        return
    }
    
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
        // 先处理请求错误
        if let reqError = error {
            print("请求出错：\(reqError.localizedDescription)")
            return
        }
        
        guard let responseData = data else {
            print("服务器未返回数据")
            return
        }
        
        // 关键！打印服务器返回的原始JSON，确认和Postman的响应完全一致
        if let rawJson = String(data: responseData, encoding: .utf8) {
            print("服务器原始响应：\n\(rawJson)")
        }
        
        // 开始解码
        do {
            let userResp = try JSONDecoder().decode(UserResponse.self, from: responseData)
            print("解码成功！用户ID：\(userResp.userInfo.id)")
            // 这里可以拿到完整的用户信息做后续处理
        } catch {
            print("解码失败：\(error.localizedDescription)")
            // 打印详细的解码错误，定位具体哪个字段出问题
            if let decodeError = error as? DecodingError {
                print("解码错误详情：\(decodeError)")
            }
        }
    }
    task.resume()
}

第三步：排查其他常见问题 #

• 如果JSON里有可选字段（比如name可能为null），Swift模型里对应的属性要加?变成可选类型
• 确认服务器返回的JSON没有语法错误（Postman正常的话这个概率低，但打印原始数据可以验证）
• 检查是否有特殊字符编码问题，比如中文或者特殊符号，确保用utf8解码

按照上面的步骤排查，基本就能解决解码失败的问题了！

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