Firebase Android报错：The client has already been terminated 问题求助

核心矛盾点 #

你描述的报错位置是获取Firebase Storage引用，但异常堆栈明确指向Firestore的写入操作（DocumentReference.set()），说明实际触发错误的代码并非Storage引用获取，而是你的uploadFileToFireStore方法中同时执行了Firestore写入，且Firestore客户端已被终止。

可能的原因及解决办法 #

1. Firestore实例被提前销毁/终止 #

• 检查是否在调用uploadFileToFireStore前，mFirebaseFirestore实例被调用了terminate()或clearPersistence()，或者实例被声明为局部变量导致生命周期过短被回收。
• 解决：将Firestore实例设为全局单例（比如放在Application类中初始化），确保在所有操作完成前实例保持活跃状态。

2. 代码逻辑混淆：Firestore与Storage操作绑定异常 #

• 你的uploadFileToFireStore方法名和堆栈显示的Firestore写入操作对应，说明该方法中同时处理了Storage上传和Firestore数据写入，但Firestore实例状态异常。
• 解决：
  • 单独检查uploadFileToFireStore中的Firestore代码，确认调用DocumentReference.set()时，Firestore实例是否有效。
  • 确保Firestore初始化完成后再执行写入操作，不要在初始化未完成阶段调用写入方法。

3. 自定义FirebaseApp实例状态异常 #

• 你使用自定义firebaseApp初始化Firestore和Storage，若该firebaseApp被提前销毁，会导致依赖它的所有服务实例失效。
• 解决：
  • 验证firebaseApp的生命周期，确保它在所有Firebase服务操作期间保持活跃。
  • 若无需多App实例，直接使用默认FirebaseApp（FirebaseFirestore.getInstance()、FirebaseStorage.getInstance()），避免自定义App带来的生命周期问题。

代码优化建议 #

将Firebase服务实例改为全局单例，示例如下：

class MyApp : Application() {
    companion object {
        lateinit var firestore: FirebaseFirestore
        lateinit var storage: FirebaseStorage
    }

    override fun onCreate() {
        super.onCreate()
        // 初始化默认FirebaseApp（若未自动初始化）
        FirebaseApp.initializeApp(this)
        
        // 初始化Firestore
        firestore = FirebaseFirestore.getInstance()
        val settings = FirebaseFirestoreSettings.Builder()
            .setPersistenceEnabled(false)
            .build()
        firestore.firestoreSettings = settings
        
        // 初始化Storage
        storage = FirebaseStorage.getInstance()
    }
}

后续上传操作中使用全局实例：

// 获取Storage引用
val storageRef = MyApp.storage.reference
// 上传文件
storageRef.child("some-dummy-file-path").putFile(fileUri)
    .addOnSuccessListener {
        Log.v(kTag, "File upload succeed")
        // 若需写入Firestore，使用全局实例确保状态有效
        MyApp.firestore.collection("uploads").document().set(uploadData)
    }.addOnFailureListener {
        Log.v(kTag, "File upload failed")
    }

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