iOS应用（Swift）中如何将文件上传到Firebase

1. 获取选中文件的名称与本地路径 #

你之前实现的文件选择功能基于UIDocumentPickerViewController，在其代理回调中即可直接获取文件的相关信息：
注意：选取的是应用沙盒外的文件，必须先开启安全域访问权限，否则无法读取文件内容

// UIDocumentPickerViewController代理方法
func documentPicker(_ controller: UIDocumentPickerViewController, didPickDocumentsAt urls: [URL]) {
    // 取选中的第一个文件，多选可遍历urls数组
    guard let selectedFileURL = urls.first else { return }
    // 开启安全域访问
    guard selectedFileURL.startAccessingSecurityScopedResource() else {
        print("无法获取文件访问权限")
        return
    }
    // 方法结束时自动关闭安全域访问，避免内存泄漏
    defer {
        selectedFileURL.stopAccessingSecurityScopedResource()
    }
    // 获取文件名
    let fileName = selectedFileURL.lastPathComponent
    // 获取文件本地完整路径
    let localFilePath = selectedFileURL.path
    // 调用上传方法
    uploadToFirebase(fileURL: selectedFileURL, fileName: fileName)
}

2. 实现文件上传到Firebase Storage #

提前确保你的项目已经完成Firebase初始化，且已开启Storage服务：

import FirebaseStorage
import FirebaseAuth // 如果需要按用户区分存储路径需要引入

func uploadToFirebase(fileURL: URL, fileName: String) {
    // 初始化Storage引用
    let storageRef = Storage.storage().reference()
    // 自定义文件在Storage中的存储路径，示例按用户UID区分目录，避免文件重名覆盖
    guard let currentUid = Auth.auth().currentUser?.uid else {
        print("用户未登录，请先完成登录流程")
        return
    }
    // 可以在文件名前加时间戳进一步避免重名
    let uniqueFileName = "\(Int(Date().timeIntervalSince1970))_\(fileName)"
    let targetRef = storageRef.child("upload_files/\(currentUid)/\(uniqueFileName)")
    
    // 启动上传任务
    let uploadTask = targetRef.putFile(from: fileURL, metadata: nil) { metadata, error in
        if let error = error {
            print("上传失败：\(error.localizedDescription)")
            return
        }
        // 上传成功后获取文件公网访问链接
        targetRef.downloadURL { downloadUrl, error in
            guard let downloadUrl = downloadUrl else {
                print("获取下载链接失败：\(error?.localizedDescription ?? "未知错误")")
                return
            }
            print("上传完成，文件访问地址：\(downloadUrl.absoluteString)")
            // 此处可将下载链接存储到Firestore或本地业务逻辑中
        }
    }
    
    // 可选：监听上传进度更新UI
    uploadTask.observe(.progress) { snapshot in
        let progress = Double(snapshot.progress!.completedUnitCount) / Double(snapshot.progress!.totalUnitCount)
        print("当前上传进度：\(Int(progress * 100))%")
    }
}

3. 常见问题排查 #

• 权限报错：检查Storage安全规则配置，测试阶段可临时放开权限验证，上线前再按业务需求收紧
• 文件读取失败：确认已经正确调用startAccessingSecurityScopedResource方法获取临时访问权限
• 文件被覆盖：上传前给文件名拼接时间戳、随机字符串等唯一标识即可解决

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