如何使用Alamofire正确获取JSON响应 解决序列化失败问题

核心根因定位 #

你遇到的responseSerializationFailed错误，90%以上概率是后端返回的内容不符合标准JSON规范导致的：你贴出的响应示例里布尔值用了Python风格的大写True/False，而RFC 8259标准规定JSON布尔值必须是小写的true/false，Alamofire默认的JSON序列化器严格遵循标准，遇到非标准格式会直接解析失败。

你已经可以通过.responseString拿到原始响应字符串，可以先逐字符检查以下常见格式问题：

• 布尔值是否为首字母大写的True/False，而非标准小写
• 数组、对象的最后一个元素后是否存在多余的尾随逗号
• 特殊字符（比如示例里的土耳其语字符ş）是否存在未转义的情况
• 响应头返回的Content-Type是否为标准的application/json，如果返回text/plain等其他类型，默认序列化器也会拦截报错

对应解决方法 #

优先方案：推动后端修正输出 #

这是最彻底的解决方式，要求后端按照JSON标准修正返回格式，包括布尔值大小写、正确的Content-Type响应头，后续所有端都不需要做额外兼容。

临时兼容方案：自定义序列化逻辑 #

如果短时间内无法修改后端，可以在客户端先对原始响应做格式归一化，再自行解析为结构化JSON对象，参考代码如下：

// 发起请求先拿原始字符串
AF.request(yourRequestURL).responseString(encoding: .utf8) { stringResp in
    guard let rawStr = stringResp.value else {
        // 先处理网络请求本身失败的场景
        return
    }
    
    // 对非标准内容做替换修正
    let normalizedStr = rawStr
        .replacingOccurrences(of: ": False", with: ": false")
        .replacingOccurrences(of: ": True", with: ": true")
        // 如果有其他格式问题可以在这里追加替换逻辑
    
    guard let jsonData = normalizedStr.data(using: .utf8) else {
        // 处理字符串转Data失败的场景
        return
    }
    
    do {
        // 解析为可直接使用的JSON结构化对象
        let jsonObj = try JSONSerialization.jsonObject(with: jsonData)
        // 如果需要转成自定义模型，在这里用JSONDecoder配合Codable协议解析即可
    } catch {
        print("解析剩余错误：\(error.localizedDescription)")
    }
}

Content-Type不匹配的修复 #

如果检查后确认JSON内容格式完全正确，只是响应头没返回正确的Content-Type，可以自定义JSON序列化器扩展允许的内容类型：

var customJsonSerializer = JSONResponseSerializer()
// 把实际返回的Content-Type加入允许列表
customJsonSerializer.acceptableContentTypes?.insert("text/plain")

AF.request(yourRequestURL)
    .response(responseSerializer: customJsonSerializer) { jsonResp in
        // 正常处理结构化JSON响应即可
    }

排查注意事项 #

• 不要直接以接口文档贴出的JSON示例为准，一定要以实际抓包拿到的原始响应字符串作为排查依据，文档示例和实际后端输出经常存在差异
• Alamofire 5.x及以上版本对JSON格式的校验比4.x版本严格很多，旧版本能容错的非标准格式在新版本里会直接报错

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