Firebase 10.15.0 Storage.swift解包nil崩溃问题求助

问题根源 #

崩溃的直接原因是调用Storage.storage()时，FirebaseApp还没完成初始化，导致FirebaseApp.app()返回nil，触发了强制解包的致命错误。你代码里直接全局声明storageRef，会在App启动阶段就执行，这时候Firebase还没来得及完成配置。

解决方案 #

1. 优先初始化Firebase

确保Firebase的配置代码在App启动时最先执行：

• SwiftUI项目：在@main标记的App结构体的init方法里调用初始化代码：

@main
struct YourAppName: App {
    init() {
        FirebaseApp.configure() // 必须放在最前面执行
    }
    
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

• UIKit项目：在AppDelegate的application(_:didFinishLaunchingWithOptions:)方法开头执行FirebaseApp.configure()

2. 延迟创建Storage引用

不要全局直接初始化storageRef，改用懒加载属性，确保Firebase初始化完成后再创建引用：

// 替换原来的全局let storageRef = Storage.storage().reference()
lazy var storageRef: StorageReference = {
    Storage.storage().reference()
}()

这样storageRef会在第一次被访问时才初始化，此时FirebaseApp.app()已经有值，不会触发nil解包错误。

3. 验证配置文件

确认GoogleService-Info.plist已正确添加到项目：

• 检查文件是否在项目目录中，且Target Membership已勾选你的App Target
• 确认plist里的STORAGE_BUCKET字段和Firebase控制台的存储桶地址一致

验证 #

修改完成后重新编译运行App，崩溃应该会消失，Storage的下载功能可以正常执行。

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