如何在Multipart HTTP POST请求中上传图片数组及拼接至NSMutableData

我来帮你搞定这两个问题，结合你给出的代码片段，整理出完整的可落地方案：

核心原理（对应问题1） #

要在Multipart HTTP POST中提交图片数组，关键是把每个图片作为独立的form-data块来处理：

• 所有图片块使用相同的字段名（比如后端约定的images[]），方便后端识别为数组
• 每个图片块必须包含：
  • Content-Disposition：指定字段名和唯一文件名（避免重复覆盖）
  • Content-Type：匹配图片实际格式（如image/jpeg对应JPG，image/png对应PNG）
  • 图片的二进制数据
• 所有块用自定义的boundary字符串分隔，请求头要声明multipart/form-data; boundary=xxx，结尾必须添加闭合的boundary标记（--boundary--）

修正你的NSMutableData拼接代码（对应问题2） #

首先给NSMutableData扩展一个实用的字符串拼接方法，方便后续操作：

extension NSMutableData {
    func appendString(_ string: String) {
        if let data = string.data(using: .utf8) {
            self.append(data)
        }
    }
}

然后完善你的createBodyWithParametersMulti函数，补上图片数组的处理逻辑：

func createBodyWithParametersMulti(parameters: [String: String]?, filePathKey: String?, imageDataArray: [NSData?], boundary: String) -> NSData {
    let body = NSMutableData()
    
    // 1. 拼接普通文本参数
    if let parameters = parameters {
        for (key, value) in parameters {
            body.appendString("--\(boundary)\r\n")
            body.appendString("Content-Disposition: form-data; name=\"\(key)\"\r\n\r\n")
            body.appendString("\(value)\r\n")
        }
    }
    
    // 2. 拼接图片数组（自动跳过空数据）
    guard let fieldName = filePathKey else { return body }
    
    for (index, imageData) in imageDataArray.enumerated() {
        guard let data = imageData else { continue }
        
        // 生成唯一文件名，可根据需求换成UUID或自定义命名规则
        let fileName = "upload_img_\(index).jpg"
        // MIME类型要和图片格式匹配，PNG请改为"image/png"
        let mimeType = "image/jpeg"
        
        body.appendString("--\(boundary)\r\n")
        body.appendString("Content-Disposition: form-data; name=\"\(fieldName)\"; filename=\"\(fileName)\"\r\n")
        body.appendString("Content-Type: \(mimeType)\r\n\r\n")
        body.append(data)
        body.appendString("\r\n")
    }
    
    // 3. 添加闭合的boundary，这一步绝对不能少，否则服务器会解析失败
    body.appendString("--\(boundary)--\r\n")
    
    return body
}

完整使用示例 #

给你一个端到端的请求发起示例，直接就能参考复用：

// 1. 生成唯一的boundary字符串
let boundary = "UploadBoundary-\(UUID().uuidString)"

// 2. 配置上传请求
let uploadURL = URL(string: "你的后端上传接口地址")!
var request = URLRequest(url: uploadURL)
request.httpMethod = "POST"
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

// 3. 准备表单参数和图片数据
let formParams = ["user_id": "1001", "upload_desc": "旅行随拍"]
let image1 = UIImage(named: "photo1")?.jpegData(compressionQuality: 0.8) as NSData?
let image2 = UIImage(named: "photo2")?.jpegData(compressionQuality: 0.8) as NSData?
let imageArray = [image1, image2]

// 4. 生成请求体
let requestBody = createBodyWithParametersMulti(
    parameters: formParams,
    filePathKey: "images[]", // 这里要和后端接收的字段名完全一致
    imageDataArray: imageArray,
    boundary: boundary
)
request.httpBody = requestBody as Data

// 5. 发起上传请求
let uploadTask = URLSession.shared.dataTask(with: request) { data, response, error in
    if let error = error {
        print("上传失败：\(error.localizedDescription)")
        return
    }
    // 处理服务器返回的响应
    if let data = data, let responseStr = String(data: data, encoding: .utf8) {
        print("上传成功，响应内容：\(responseStr)")
    }
}
uploadTask.resume()

关键注意事项 #

• 后端接口必须支持多文件上传，且字段名要和你设置的filePathKey一致（比如示例中的images[]）
• 如果是PNG图片，记得把mimeType改成image/png，否则后端可能无法识别图片格式
• 若你的项目已经升级到Swift 5+，建议用Data代替NSData，只需做少量类型转换即可

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