Alamofire中API调用失败但Postman可正常运行，请求技术协助

这种Postman跑通但Alamofire卡壳的情况真的太闹心了，我之前踩过不少类似的坑，咱们一步步拆解可能的问题：

1. 先确认参数编码方式是否匹配 #

Postman和Alamofire默认的参数编码逻辑可能不一样，尤其是你参数里有嵌套数组（products字段），这很容易出问题：

• 先看Postman的请求头：如果Content-Type是application/json，那Alamofire必须用JSONEncoding，而不是默认的URLEncoding（后者会把嵌套数组转成products[0][pid]=72这种格式，后端大概率不识别）。
• 正确的Alamofire请求示例：

  let parameters = [
      "paymenttype":"debitcard",
      "coupon":"",
      "products":[["pid":"72","qnty":"1"],["pid":"4","qnty":"1"],["pid":"3","qnty":"1"]],
      "grandtotal":"..." // 这里确保值和Postman完全一致
  ]
  
  AF.request("你的API地址", method: .post, parameters: parameters, encoding: JSONEncoding.default)
      .responseJSON { response in
          // 打印响应详情辅助排查
          print(response.debugDescription)
      }
  

2. 检查空值是否被正确发送 #

你参数里的coupon是空字符串，Alamofire默认的JSONEncoding会保留空值，但如果是自定义编码或者用了URLEncoding，可能会过滤掉空值。可以通过自定义编码器确保空字符串被正常序列化：

let customEncoder = JSONEncoder()
customEncoder.outputFormatting = .prettyPrinted // 方便查看序列化后的格式

let jsonEncoding = JSONEncoding.custom { request, parameters in
    guard let params = parameters else { return (request, nil) }
    do {
        let data = try customEncoder.encode(params)
        var modifiedRequest = request
        modifiedRequest.setValue("application/json; charset=utf-8", forHTTPHeaderField: "Content-Type")
        return (modifiedRequest, .data(data))
    } catch {
        return (request, .failure(error))
    }
}

// 用这个自定义编码发送请求
AF.request("你的API地址", method: .post, parameters: parameters, encoding: jsonEncoding)

3. 对比Postman和Alamofire的请求头 #

Postman里可能有一些你没注意到的请求头（比如Authorization令牌、User-Agent、Accept等），这些缺失会导致后端拒绝请求：

• 打开Postman的「Code」功能（右上角</>图标），选择「Swift - Alamofire」，生成的代码里会包含所有请求头，和你自己的代码对比，把缺失的头补上。

4. 开启Alamofire日志，对比实际发送的请求 #

最直接的方法是看Alamofire实际发出去的请求是什么样的，和Postman的请求详情（Body、Headers、URL）一一对比：

• 自定义一个日志监视器：

  class APILogger: EventMonitor {
      func requestDidResume(_ request: Request) {
          print("\n=== 请求开始 ===")
          print("URL: \(request.request?.url?.absoluteString ?? "")")
          print("方法: \(request.request?.httpMethod ?? "")")
          print("请求头: \(request.request?.allHTTPHeaderFields ?? [:])")
          if let bodyData = request.request?.httpBody, let bodyString = String(data: bodyData, encoding: .utf8) {
              print("请求体: \(bodyString)")
          }
          print("=== 请求结束 ===\n")
      }
  
      func request<Value>(_ request: DataRequest, didParseResponse response: DataResponse<Value, AFError>) {
          print("\n=== 响应开始 ===")
          print("状态码: \(response.response?.statusCode ?? -1)")
          if let data = response.data, let responseString = String(data: data, encoding: .utf8) {
              print("响应体: \(responseString)")
          }
          print("=== 响应结束 ===\n")
      }
  }
  
  // 创建带日志的Session
  let session = Session(eventMonitors: [APILogger()])
  // 用这个session发送请求
  session.request("你的API地址", method: .post, parameters: parameters, encoding: JSONEncoding.default)
      .responseJSON { response in
          // 处理响应
      }
  

• 把日志里的请求体、头和Postman里的「Raw」请求内容对比，任何细微差异（比如引号、逗号、数据类型）都可能是问题所在。

5. 检查数据类型是否一致 #

比如grandtotal是字符串还是数字？Postman可能会自动把字符串转成数字，但Alamofire严格按照你定义的参数类型发送。如果后端期望grandtotal是数字类型，你传字符串就会报错，得把参数改成"grandtotal": 123.45（数字类型）。同理，pid和qnty如果后端期望是数字，也要对应调整类型。

按照这个流程排查，大概率能找到问题——毕竟Postman能跑通，说明API本身没问题，差异肯定出在Alamofire发送的请求细节上。

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