如何使用Alamofire 4上传任意类型及数量的文件？

我完全理解你的困扰——网上大多是单张图片的上传示例，但实际项目里要处理几十种文件类型、任意数量的文件确实麻烦。我之前做过类似的需求，给你分享两个可行的方案，附带完整代码示例：

核心问题先理清 #

你之前遇到的两个关键坑：

• 用Bundle.main.url(forResource:)是获取APP内置资源的，而你导入的文件（相册、相机、文档选择器来的）都存于沙盒中，要用用户选择的实际文件URL，不是Bundle里的路径
• 手动指定mimeType不现实，我们可以通过系统API自动获取每个文件的MIME类型

方案一：MultipartFormData多文件上传（推荐，适配大多数后端） #

这是后端最常用的接收方式，支持同时传参数和多个文件。

步骤1：自动获取文件的MIME类型 #

先写一个工具函数，根据文件URL自动返回对应的MIME类型：

import MobileCoreServices

func getMimeType(for fileURL: URL) -> String {
    if let uti = UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, fileURL.pathExtension as CFString, nil)?.takeRetainedValue() {
        if let mimeType = UTTypeCopyPreferredTagWithClass(uti, kUTTagClassMIMEType)?.takeRetainedValue() {
            return mimeType as String
        }
    }
    // 兜底默认类型（适配所有未知文件）
    return "application/octet-stream"
}

步骤2：处理多文件上传的完整代码 #

假设你已经收集了所有要上传的文件URL数组fileURLs: [URL]，还有需要传的参数parameters: [String: Any]：

import Alamofire

func uploadMultipleFiles(to serverURL: String, files: [URL], parameters: [String: Any], completion: @escaping (Result<Any, Error>) -> Void) {
    AF.upload(multipartFormData: { multipartFormData in
        // 先添加请求参数
        for (key, value) in parameters {
            if let data = "\(value)".data(using: .utf8) {
                multipartFormData.append(data, withName: key)
            }
        }
        
        // 循环添加所有文件
        for (index, fileURL) in files.enumerated() {
            // 处理文档选择器的安全范围资源（必须加，否则可能无法访问文件）
            let isSecurityScoped = fileURL.startAccessingSecurityScopedResource()
            
            // 获取文件名和自动匹配的MIME类型
            let fileName = fileURL.lastPathComponent
            let mimeType = getMimeType(for: fileURL)
            
            // 读取文件并添加到表单
            do {
                let fileData = try Data(contentsOf: fileURL)
                // 这里的withName要和后端约定好，比如后端接收文件的字段是"files[]"或者"file_\(index)"
                multipartFormData.append(fileData, withName: "files[]", fileName: fileName, mimeType: mimeType)
            } catch {
                print("读取文件失败：\(error.localizedDescription)")
            }
            
            // 记得停止访问安全范围资源，避免内存泄漏
            if isSecurityScoped {
                fileURL.stopAccessingSecurityScopedResource()
            }
        }
    }, to: serverURL)
    .responseJSON { response in
        switch response.result {
        case .success(let value):
            completion(.success(value))
        case .failure(let error):
            completion(.failure(error))
        }
    }
}

关键注意点 #

• 文档选择器（UIDocumentPickerViewController）返回的URL是安全范围资源，必须调用startAccessingSecurityScopedResource()才能读取，用完一定要调用stopAccessingSecurityScopedResource()释放权限
• withName字段要和后端开发人员确认，比如后端可能用files接收数组，或者file_0、file_1这样的序列化字段名
• 如果是相机拍摄的图片/视频，你需要先把临时文件保存到沙盒的Documents或tmp目录，再拿到对应的URL用于上传

方案二：直接上传单个文件（适用于后端支持直接接收文件的场景） #

如果后端不需要表单，只需要直接上传文件内容，你可以用Alamofire的直接文件上传方法，但要注意这里的fileURL是用户导入的沙盒URL，不是Bundle里的：

func uploadSingleFile(to serverURL: String, fileURL: URL, completion: @escaping (Result<Any, Error>) -> Void) {
    // 处理安全范围资源权限
    let isSecurityScoped = fileURL.startAccessingSecurityScopedResource()
    
    AF.upload(fileURL, to: serverURL)
        .responseJSON { response in
            switch response.result {
            case .success(let value):
                completion(.success(value))
            case .failure(let error):
                completion(.failure(error))
            }
            
            // 释放资源权限
            if isSecurityScoped {
                fileURL.stopAccessingSecurityScopedResource()
            }
        }
}

测试建议 #

1. 先打印每个文件的fileURL、fileName、mimeType，确认信息正确
2. 用Charles抓包，看看请求里的multipart表单是否包含了所有文件和参数
3. 如果上传失败，优先检查后端的接收逻辑是否和你的请求字段匹配

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