iOS应用发送手机号和密码至服务器的Swift URL请求失败排查

嘿，我之前也踩过这个坑！Postman能正常请求但Swift代码报错，基本都是form-data的构造细节没处理到位——毕竟Postman会帮你自动搞定边界生成、头信息设置这些底层活，而Swift得咱们手动来。下面是我总结的常见问题和修复方案：

1. 错误的Content-Type设置 #

很多人会直接把Content-Type设为multipart/form-data，但form-data请求必须带边界（boundary）——这个随机字符串是用来分隔不同字段的关键，Postman会自动生成，但Swift里得手动指定：

❌ 错误示例：

request.setValue("multipart/form-data", forHTTPHeaderField: "Content-Type")

✅ 正确做法：

let boundary = UUID().uuidString
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

2. Form-Data字段编码格式错误 #

form-data的每个字段都需要用边界包裹，还要包含Content-Disposition等头信息，直接拼接参数肯定会报错。给你一个完整的正确构造示例：

func sendLoginRequest(phone: String, password: String) {
    guard let url = URL(string: "你的接口地址") else { 
        print("无效的接口URL")
        return 
    }
    
    var request = URLRequest(url: url)
    request.httpMethod = "POST" // 确保是POST方法，form-data一般不用GET
    
    let boundary = UUID().uuidString
    request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
    
    // 逐步构造form-data请求体
    var body = Data()
    
    // 添加手机号字段
    body.append("--\(boundary)\r\n".data(using: .utf8)!)
    body.append("Content-Disposition: form-data; name=\"phone\"\r\n\r\n".data(using: .utf8)!)
    body.append("\(phone)\r\n".data(using: .utf8)!)
    
    // 添加密码字段
    body.append("--\(boundary)\r\n".data(using: .utf8)!)
    body.append("Content-Disposition: form-data; name=\"password\"\r\n\r\n".data(using: .utf8)!)
    body.append("\(password)\r\n".data(using: .utf8)!)
    
    // 必须添加结束边界
    body.append("--\(boundary)--\r\n".data(using: .utf8)!)
    
    request.httpBody = body
    
    // 发送请求并处理响应
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
        if let error = error {
            print("请求失败：\(error.localizedDescription)")
            return
        }
        
        guard let httpResponse = response as? HTTPURLResponse, 
              (200...299).contains(httpResponse.statusCode) else {
            print("响应状态码异常")
            return
        }
        
        if let data = data, let responseStr = String(data: data, encoding: .utf8) {
            print("请求成功，响应内容：\(responseStr)")
        }
    }
    task.resume()
}

3. 参数名不匹配（最容易忽略的坑） #

仔细核对你的字段名：比如后端要求的是mobile还是phone？是pwd还是password？Postman里你可能写对了，但Swift代码里打错一个字母就会导致后端识别不到参数，直接报错。

4. 额外头信息缺失或冲突 #

Postman会默认添加一些头信息（比如User-Agent），如果你的Swift代码里没有设置，或者设置了和后端预期不符的头，也可能被拒绝。可以尝试添加和Postman一致的User-Agent：

request.setValue("PostmanRuntime/7.32.3", forHTTPHeaderField: "User-Agent")

把构造好的请求体转成字符串打印出来，和Postman的原始请求体对比（Postman里切换到Body的Raw视图就能看到），格式差异一眼就能看出来：

if let bodyStr = String(data: body, encoding: .utf8) {
    print("构造的请求体：\n\(bodyStr)")
}

这样就能快速定位问题啦！

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