使用URLSession上传图片失败，请求排查问题原因

核心问题总结 #

你遇到的请求体被忽略、上传失败的问题，主要源于手动构建multipart/form-data时的格式错误，以及代码中的逻辑疏漏，和URLSession本身的机制无关。下面逐一拆解问题并给出修复方案：

代码中的关键错误 #

1. Boundary与请求体格式不匹配

   • 你在URLRequest的extension中已经实现了完整的multipart构建逻辑，但第二段代码却重复手动设置boundary，且httpBody变量未定义（这直接导致请求体为空）。
   • 另外，multipart请求体的结尾必须是--{boundary}--\r\n，你的extension代码最后只添加了--\(boundary)--，缺少末尾的换行符，这会导致服务器无法正确解析请求体。

2. 强制解包的风险

   • Data的extension中使用!强制解包String.data(using: .utf8)，如果字符串包含UTF-8无法编码的字符，会直接崩溃，应该用可选绑定处理。

3. 重复设置Content-Type

   • 第二段代码手动设置了Content-Type，但如果同时调用extension的setMultipartFormDataBody方法，会导致header被覆盖，引发boundary不一致的问题。

URLSession vs Alamofire的机制差异 #

• URLSession：是苹果提供的底层网络API，仅提供基础的请求发送能力，不内置multipart/form-data的构建工具，需要开发者手动处理boundary、请求体编码等细节。
• Alamofire：基于URLSession封装的第三方库，已经帮你封装了multipart请求的构建、boundary自动生成、错误处理、进度回调等逻辑，无需手动实现底层细节，减少出错概率。

修复后的完整代码 #

修正后的URLRequest扩展

import Foundation

extension URLRequest {
    mutating func setMultipartFormDataBody(params: [String: (Data?, filename: String?)]) {
        let boundary = UUID().uuidString
        self.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
        
        var body = Data()
        for (key, (data, filename)) in params {
            // 添加分隔符
            guard let boundaryData = "--\(boundary)\r\n".data(using: .utf8) else { continue }
            body.append(boundaryData)
            
            // 构造Content-Disposition
            let dispositionString: String
            if let filename = filename {
                dispositionString = "Content-Disposition: form-data; name=\"\(key)\"; filename=\"\(filename)\"\r\n"
            } else {
                dispositionString = "Content-Disposition: form-data; name=\"\(key)\"\r\n"
            }
            guard let dispositionData = dispositionString.data(using: .utf8) else { continue }
            body.append(dispositionData)
            
            // 添加空行分隔头部和内容
            guard let newlineData = "\r\n".data(using: .utf8) else { continue }
            body.append(newlineData)
            
            // 添加内容数据
            if let data = data {
                body.append(data)
            }
            body.append(newlineData)
        }
        
        // 添加结束分隔符（必须带换行）
        guard let endBoundaryData = "--\(boundary)--\r\n".data(using: .utf8) else { return }
        body.append(endBoundaryData)
        
        self.httpBody = body
    }
}

正确的请求使用示例

// 替换为你的实际接口URL
guard let url = URL(string: "https://your-server-url.com/upload") else {
    print("Invalid URL")
    return
}

var request = URLRequest(url: url)
request.httpMethod = "POST"

// 构造请求参数：字符串参数+图片参数
let params: [String: (Data?, filename: String?)] = [
    "username": ("john_doe".data(using: .utf8), nil),
    "avatar": (UIImage(named: "avatar")?.jpegData(compressionQuality: 0.8), "avatar.jpg")
]

request.setMultipartFormDataBody(params: params)

// 发送请求并处理响应
URLSession.shared.dataTask(with: request) { data, response, error in
    // 先排查错误
    if let error = error {
        print("请求错误: \(error.localizedDescription)")
        return
    }
    
    // 检查响应状态码
    if let httpResponse = response as? HTTPURLResponse {
        print("响应状态码: \(httpResponse.statusCode)")
    }
    
    // 解析响应数据
    if let data = data, let responseString = String(data: data, encoding: .utf8) {
        print("响应内容: \(responseString)")
    }
}.resume()

调试建议 #

1. 抓包验证请求：用Charles或Proxyman抓包，查看请求的Content-Type和请求体是否符合格式要求，确认boundary一致、结尾有正确的换行。
2. 打印错误与响应：在dataTask的回调中打印error、response和响应数据，明确是客户端请求格式错误还是服务器端问题。
3. 测试简单请求：先上传一个纯字符串参数，确认请求能被服务器接收后，再添加图片数据。

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