iOS Swift：使用Document Picker从URL上传文档文件报错求助

我来帮你搞定这个文档上传的问题！首先，你之前的图片上传代码是直接用imageData，但文档上传需要处理安全作用域URL（iOS对Document Picker返回的文件URL有访问限制），这大概率是你报错的核心原因。下面是完整的解决方案：

一、先明确常见报错原因 #

• 没有处理iOS的安全作用域资源访问：Document Picker返回的URL属于安全作用域，必须主动申请访问权限才能读取文件内容
• 硬写固定的mimeType：不同文档（PDF/Word/Excel等）的MIME类型不同，硬写会导致服务端解析失败
• 文件数据读取失败：比如URL无效、文件不存在，或者没有正确处理异步读取

二、完整实现步骤 #

1. 配置Document Picker并获取文件URL #

首先确保你的ViewController遵循UIDocumentPickerDelegate，然后弹出选择器：

func openDocumentPicker() {
    let documentPicker = UIDocumentPickerViewController(documentTypes: ["public.item"], in: .import)
    documentPicker.delegate = self
    documentPicker.allowsMultipleSelection = false // 根据需求设置是否允许多选
    present(documentPicker, animated: true)
}

2. 处理Document Picker代理方法（关键：安全作用域权限） #

在代理方法中获取文件URL，并处理安全作用域访问：

func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
    guard let fileURL = urls.first else { return }
    
    // 关键：申请安全作用域访问权限
    guard fileURL.startAccessingSecurityScopedResource() else {
        print("无法获取文件访问权限")
        return
    }
    
    // 调用上传方法
    uploadDocument(fileURL: fileURL, params: ["key1": "value1", "key2": "value2"])
    
    // 用完一定要释放权限（放在defer里确保执行）
    defer {
        fileURL.stopAccessingSecurityScopedResource()
    }
}

3. 修改Alamofire上传代码（适配文档文件） #

这里推荐直接用Alamofire的append(_ url: URL, withName: String, fileName: String, mimeType: String)方法，比自己读取Data更高效，还能避免内存占用过高：

func uploadDocument(fileURL: URL, params: [String: Any]) {
    let pageURL = "你的服务端上传接口地址"
    
    // 获取文件的正确MIME类型（避免硬写）
    let mimeType = fileURL.mimeType ?? "application/octet-stream"
    // 获取文件名（从URL中提取）
    let fileName = fileURL.lastPathComponent
    
    Alamofire.upload(multipartFormData: { multipartFormData in
        // 添加上传参数
        for (key, value) in params {
            guard let data = "\(value)".data(using: .utf8) else { continue }
            multipartFormData.append(data, withName: key)
        }
        
        // 直接添加文件URL（Alamofire会自动处理文件读取）
        do {
            try multipartFormData.append(fileURL, withName: "upload_file", fileName: fileName, mimeType: mimeType)
        } catch {
            print("添加文件到Multipart失败：\(error.localizedDescription)")
        }
    }, to: pageURL) { result in
        switch result {
        case .success(let upload, _, _):
            // 停止加载动画
            self.stopLoader()
            
            // 监听上传进度
            upload.uploadProgress { progress in
                print("上传进度：\(progress.fractionCompleted * 100)%")
            }
            
            // 处理上传响应
            upload.responseJSON { response in
                switch response.result {
                case .success(let value):
                    print("上传成功：\(value)")
                    // 这里处理服务端返回的数据
                case .failure(let error):
                    print("上传失败：\(error.localizedDescription)")
                }
            }
            
        case .failure(let error):
            self.stopLoader()
            print("Multipart构建失败：\(error.localizedDescription)")
        }
    }
}

4. 补充：获取文件MIME类型的扩展 #

为了正确获取不同文档的MIME类型，给URL添加一个扩展：

import MobileCoreServices

extension URL {
    var mimeType: String? {
        let pathExtension = self.pathExtension
        guard let uti = UTTypeCreatePreferredIdentifierForTag(kUTTagClassFilenameExtension, pathExtension as NSString, nil)?.takeRetainedValue() else {
            return nil
        }
        return UTTypeCopyPreferredTagWithClass(uti, kUTTagClassMIMEType)?.takeRetainedValue() as String?
    }
}

三、关键注意点 #

• 安全作用域权限：必须调用startAccessingSecurityScopedResource()和stopAccessingSecurityScopedResource()，否则会无法读取文件，甚至崩溃
• MIME类型：不要硬写image/jpeg这类图片的MIME，用上面的扩展自动获取，确保服务端能正确解析
• 大文件上传：用append(fileURL)比自己读取Data更节省内存，适合大文档上传
• 错误处理：在各个环节添加错误捕获，方便排查问题

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