Android Studio中如何将Firestore获取的数据赋值给全局变量

问题根因 #

Firestore的数据库读写操作默认是异步执行的，你在主线程同步读取全局变量时，Firestore的请求还没收到服务端响应，赋值逻辑还没触发，因此会拿到空值。

实现&修复步骤 #

• 第一步：提前定义全局变量，建议在自定义Application类或者对应ViewModel中声明，避免内存泄漏：

  // 自定义Application类示例（需要在AndroidManifest.xml中注册name属性）
  class MyApp: Application() {
      // 根据你的业务需要修改变量类型，做好空安全声明
      var firestoreGlobalValue: String? = null
  }
  

• 第二步：必须在Firestore的异步回调内部完成全局变量赋值，禁止在回调外部同步读取未赋值的变量：
  常见错误写法示例：

  // 错误：回调外同步读取变量，此时请求还未返回
  var temp: String? = null
  db.collection("testCollection").document("testDoc")
      .get()
      .addOnSuccessListener { doc ->
          temp = doc.getString("targetField")
      }
  // 此处输出必然为空，addOnSuccessListener还未触发
  Log.d("DEBUG", temp ?: "空值")
  

  正确写法示例：

  db.collection("testCollection").document("testDoc")
      .get()
      .addOnSuccessListener { doc ->
          if (doc.exists()) {
              // 直接在回调内部给全局变量赋值
              (applicationContext as MyApp).firestoreGlobalValue = doc.getString("targetField")
              // 所有需要用到该值的业务逻辑，要么放在此处执行，要么用观察者模式通知
              Log.d("DEBUG", "全局变量赋值成功：${(applicationContext as MyApp).firestoreGlobalValue}")
          }
      }
      .addOnFailureListener { e ->
          Log.w("DEBUG", "Firestore读取失败", e)
      }
  

• 第三步：如果需要在多个页面使用该全局变量，推荐用LiveData/Flow做观察者封装，避免频繁空判断：

  // 修改MyApp中的全局变量声明
  val firestoreLiveData = MutableLiveData<String?>()
  
  // 赋值时修改为
  addOnSuccessListener { doc ->
      firestoreLiveData.postValue(doc.getString("targetField"))
  }
  
  // 其他页面直接观察即可，有值时自动触发回调
  (application as MyApp).firestoreLiveData.observe(this) { value ->
      value?.let {
          // 执行你的业务逻辑
      }
  }
  

注意事项 #

• 禁止用Thread.sleep等阻塞主线程的方式等待异步返回，会触发ANR异常
• 全局变量要做好空安全处理，避免未赋值时调用出现空指针
• 如果存储的是复杂实体类，要确保Firestore可以正确序列化，必要时给实体类加@Serializable注解

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