iOS Swift中用Alamofire多表单数据上传PDF、图片数组及额外参数

准备工作 #

确保项目已集成Alamofire，可通过CocoaPods或Swift Package Manager完成依赖添加。

核心实现步骤 #

1. 准备待上传数据
   先定义好图片数据数组、PDF文件数据数组，以及需要附带的discount参数：

// 示例discount参数
let discount = ["widgetType":"FELLOWSHIP_DISCOUNT","type":"FELLOWSHIP","widgetId":1] as [String:Any]
// 图片数据数组（需自行从相册/本地读取转成Data）
let imagesData: [Data] = [/* 你的图片Data集合 */]
// PDF文件数据数组（需自行从本地读取或生成转成Data）
let pdfDataArray: [Data] = [/* 你的PDF Data集合 */]

2. 构建Multipart上传请求
   使用Alamofire的upload方法，通过multipartFormData拼接文件和参数：

import Alamofire

Alamofire.upload(
    multipartFormData: { multipartFormData in
        // 1. 批量添加图片到files字段
        for (index, imageData) in imagesData.enumerated() {
            // withName需与服务器约定的字段名一致，这里对应示例中的"files"数组
            // 文件名和MIME类型根据实际文件调整，比如png用image/png
            multipartFormData.append(imageData,
                                    withName: "files[\(index)]",
                                    fileName: "image_\(index).jpg",
                                    mimeType: "image/jpeg")
        }
        
        // 2. 批量添加PDF到files字段（续接图片的索引）
        let startIndex = imagesData.count
        for (index, pdfData) in pdfDataArray.enumerated() {
            multipartFormData.append(pdfData,
                                    withName: "files[\(startIndex + index)]",
                                    fileName: "document_\(index).pdf",
                                    mimeType: "application/pdf")
        }
        
        // 3. 添加discount参数（两种方式二选一，根据服务器要求）
        // 方式一：字典转JSON Data上传（适用于服务器接受JSON格式参数）
        if let discountJsonData = try? JSONSerialization.data(withJSONObject: discount, options: []) {
            multipartFormData.append(discountJsonData,
                                    withName: "discount",
                                    mimeType: "application/json")
        }
        
        // 方式二：拆分成表单嵌套字段上传（适用于服务器接受表单格式嵌套参数）
        // multipartFormData.append("FELLOWSHIP_DISCOUNT".data(using: .utf8)!, withName: "discount[widgetType]")
        // multipartFormData.append("FELLOWSHIP".data(using: .utf8)!, withName: "discount[type]")
        // multipartFormData.append("1".data(using: .utf8)!, withName: "discount[widgetId]")
    },
    to: "https://your-server-url.com/upload", // 替换为你的服务器接口地址
    method: .post,
    encodingCompletion: { encodingResult in
        switch encodingResult {
        case .success(let upload, _, _):
            // 处理上传响应
            upload.responseJSON { response in
                switch response.result {
                case .success(let responseData):
                    print("上传成功，响应数据：\(responseData)")
                    // 这里可解析响应数据，处理业务逻辑
                case .failure(let error):
                    print("上传失败：\(error.localizedDescription)")
                    // 处理错误，比如提示用户上传失败
                }
            }
        case .failure(let error):
            print("表单编码失败：\(error.localizedDescription)")
        }
    }
)

关键注意事项 #

• 字段名匹配：withName的值必须和服务器端定义的字段完全一致，比如示例中的files和discount。
• MIME类型：文件的MIME类型要准确，图片常用image/jpeg、image/png，PDF固定为application/pdf，否则服务器可能无法正确解析文件。
• 文件名：文件名可自定义，建议带上索引避免重名，方便服务器区分存储。
• 参数格式：discount参数的上传方式取决于服务器的接受格式，需提前和后端确认是JSON格式还是表单嵌套格式。
• 错误处理：要覆盖编码失败、上传失败等场景，给用户合理的操作反馈。

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