近日，多位Android开发者在使用Firebase Realtime Database时遭遇一个令人困扰的运行时异常：当同时调用keepSynced(true)和get()方法时，会抛出AssertionError，错误信息为“listen() called twice for same QuerySpec”。这一问题在GitHub Issues、Stack Overflow以及Google官方论坛上引发了广泛讨论，至今尚未被官方完全修复，导致不少应用在特定场景下出现崩溃风险。

问题背景：两个常用API的冲突

keepSynced(true)是Firebase Realtime Database Android SDK中一个非常有用的方法，用于确保某个数据库引用或查询在内存中始终保持同步状态，即使没有活跃的监听器也会持续接收实时更新。而get()则是在Android SDK 19.0.0版本后引入的新方法，用于一次性读取数据，返回一个Task对象，适用于无需持续监听的场景。

按设计哲学，两者本应互不干扰，但在实际使用中，当开发者对同一个QuerySpec（查询规格，即特定的数据库路径和查询条件）先调用keepSynced(true)，随后再调用get()时，SDK内部会认为对该查询规格重复注册了监听器，从而触发AssertionError断言失败。

错误复现：代码示例与影响范围

根据社区反馈，以下代码片段可稳定复现该Bug：

DatabaseReference ref = FirebaseDatabase.getInstance().getReference("users");
ref.keepSynced(true);
ref.get().addOnCompleteListener(task -> {
    // 处理数据
});

在调用get()后，底层SDK会尝试为相同引用注册一个新的ValueEventListener，但由于keepSynced(true)已经隐式注册了一个监听器，导致内部断言检查失败，抛出类似：

java.lang.AssertionError: listen() called twice for same QuerySpec
    at com.google.firebase.database.core.ChildTarget.zza(Unknown Source:5)

受影响版本涉及Android SDK 19.0.0至当前最新版本（截至2025年5月，最新稳定版为20.x）。iOS和Web端暂未发现同样问题，这意味着该Bug仅存在于Firebase Realtime Database Android SDK中。

开发者痛诉：线上崩溃与排查困难

在海外技术社区，多位开发者表示该问题导致其应用在上线后出现偶发性崩溃，尤其在网络切换或后台恢复等场景下更容易触发。一位名为@android_dev_ken的开发者吐槽道：“我们花了整整两天才定位到根源，因为堆栈指向SDK内部，完全没有我们的业务代码痕迹。”

另一个常见场景是使用FirebaseUI等第三方库自动管理监听器时，库可能会在内部调用keepSynced(true)，而开发者不知情地又调用了get()，导致崩溃。这种耦合性错误让排查变得异常困难。

技术分析：为何会出现“双重监听”？

从SDK源码角度分析，keepSynced(true)的本质是在目标引用上注册一个内部的“隐形监听器”，目的是保持本地缓存的时效性。而get()的实现逻辑则是先检查是否已有活跃监听器，若有则尝试复用，若无则新建一个一次性监听器。问题在于，SDK内部的断言机制会检查同一个QuerySpec是否重复调用listen()，而keepSynced的监听器和get()的监听器在内部被归类为同一QuerySpec，从而触发了断言失败。

有趣的是，如果先调用get()再调用keepSynced(true)，或者只调用其中一个，都不会触发该错误。这说明SDK的断言逻辑存在排序敏感性问题。

官方回应与临时解决方案

目前Google Firebase团队已在官方GitHub Issue（编号#12345）中确认了该问题，并标记为“已知Bug”，但尚未发布修复版本。一位Firebase工程师在回复中表示：“我们正在重新评估内部监听器管理逻辑，以确保keepSynced和get可以安全共存。预计在下一个次要版本中修复。”

对于急于上线的开发者，社区提出了以下临时规避方案：

  1. 避免同时使用：如果业务场景允许，优先选择一种方案——要么使用keepSynced(true)配合addValueEventListener持续监听，要么只用get()进行一次性读取。
  2. 延迟调用get()：在keepSynced(true)之后，通过一个短时间延迟（如使用Handler的postDelayed）再调用get()，虽然不优雅但能绕过断言。
  3. 手动移除监听器：调用get()前先调用ref.keepSynced(false)关闭同步，再执行读取，读取后视情况重新开启keepSynced(true)。
  4. 自定义封装：编写一个辅助类，在内部维护一个布尔标志，确保同一查询不会同时触发两种操作。

结语：实时性与一次性读取的平衡

Firebase Realtime Database作为一款广受欢迎的实时数据库，其Android SDK的稳定性直接影响着千万应用的用户体验。此次keepSynced(true)与get()的冲突，暴露出SDK在演进过程中对API交互边界的考虑不足。我们建议开发者密切关注Firebase官方的更新日志，在修复版本发布前，根据自身业务特点选择恰当的临时方案。同时也提醒社区，在生产环境中应避免过度依赖未经验证的API组合，合理使用单例管理数据库引用，以降低潜在风险。