Swift使用Alamofire从Firebase Storage下载文件报错排查

你遇到的两个编译错误核心原因是Alamofire版本不匹配：你参考的示例基于Alamofire 4.x编写，但项目中集成的是Alamofire 5.x及以上版本，大版本更新时下载相关API做了破坏性变更，旧写法完全不兼容。
除此之外你的代码还有4处逻辑问题，会导致后续运行崩溃：

• previewItem属性声明错误，var previewItem = URL?.self拿到的是URL可选类型的元类型，不是用来存储本地文件路径的实例属性
• 下载路径拼接时使用了未定义的documentFilename变量，本身就不符合编译规则
• 外部传入的refrenceDocURL没有绑定下载触发逻辑，页面加载后不会执行任何操作
• 下载结果没有做错误校验，网络异常时会因为空URL导致预览器崩溃

直接替换原有类的代码即可，已经兼容PDF、图片等所有QuickLook支持的预览格式：

import UIKit
import Alamofire
import QuickLook

class DocumentViewer: UIViewController{
    // 修正：正确声明存储预览文件本地路径的属性
    var previewItem: URL?
    // 外部传入的远端文件URL
    var refrenceDocURL: URL?
    
    override func viewDidLoad() {
        super.viewDidLoad()
        view.backgroundColor = .white
        // 页面加载后自动校验传入的URL并触发下载
        guard let sourceURL = refrenceDocURL else { return }
        downloadFile(fileUrl: sourceURL)
    }
    
    func downloadFile(fileUrl: URL) {
        // 修正：使用Alamofire 5的Destination类型替换旧版废弃的DownloadFileDestination
        let destination: DownloadRequest.Destination = { _, response in
            let documentsURL = FileManager.default.urls(for: .documentDirectory, in: .userDomainMask)[0]
            // 直接取服务端返回的建议文件名，无需手动定义文件名变量
            let fileName = response.suggestedFilename ?? "previewFile"
            let fileURL = documentsURL.appendingPathComponent(fileName)
            // 下载配置：覆盖同名旧文件、自动创建不存在的中间目录
            return (fileURL, [.removePreviousFile, .createIntermediateDirectories])
        }

        // 修正：用AF.download替换旧版废弃的Alamofire.download全局方法
        AF.download(fileUrl, to: destination)
            .response { [weak self] downloadResponse in
                guard let self = self else { return }
                // 下载失败直接打印错误返回，避免强制解包崩溃
                if let downloadError = downloadResponse.error {
                    print("文件下载失败: \(downloadError.localizedDescription)")
                    return
                }
                // 确认拿到本地存储路径后再弹出预览器
                guard let localFileURL = downloadResponse.fileURL else { return }
                self.previewItem = localFileURL
                let previewController = QLPreviewController()
                previewController.dataSource = self
                self.present(previewController, animated: true)
            }
    }
}

extension DocumentViewer: QLPreviewControllerDataSource {
    func numberOfPreviewItems(in controller: QLPreviewController) -> Int {
        // 只有下载成功拿到有效文件路径才返回1，避免预览空文件
        return previewItem != nil ? 1 : 0
    }

    func previewController(_ controller: QLPreviewController, previewItemAt index: Int) -> QLPreviewItem {
        // URL本身遵守QLPreviewItem协议，可直接返回
        return previewItem! as QLPreviewItem
    }
}

• 如果Firebase Storage的资源设置了访问权限，不要直接拼公开URL下载，优先用Firebase Storage SDK提供的取文件接口，避免权限校验失败导致下载403
• 如果下载的文件不需要长期留存，可以把存储路径从Documents目录换成系统临时目录FileManager.default.temporaryDirectory，减少应用存储空间占用
• 预览大体积PDF/高清图片时建议加个加载态提示，避免用户以为页面无响应

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