Firebase RTDB离线缓存异常：未同步节点请求未按预期失败

问题原因 #

开启Firebase RTDB持久化（db.setPersistenceEnabled(true)）后，keepSynced(false)仅停止节点的主动同步，不会删除已存在的本地缓存。离线查询该节点时：

• 若缓存存在，SDK默认优先读取缓存，触发onSuccessListener返回缓存数据，未按预期失败；
• 若缓存为空，SDK可能因无法连接服务器且无缓存数据，出现无回调情况；
  日志中“get for query /timeline/240306/stations falling back to disk cache after error: Client is offline”也印证了SDK fallback到缓存的行为。

解决方案 #

1. 强制从服务器查询 #

修改查询代码，指定Source.SERVER，跳过本地缓存直接请求服务器。离线状态下该请求会失败，触发onFailureListener：

val ref = database
            .getReference("timeline/240306/stations")
            .orderByChild("tripName")
            .equalTo(tripNameDouble)

ref.get(Source.SERVER)
    .addOnSuccessListener{...}
    .addOnFailureListener{...}
    .addOnCanceledListener{...} 

2. 清除本地缓存 #

若无需保留目标节点缓存，可调用purgeLocalCache()清除所有本地缓存（注意：此操作会清除所有节点缓存，需谨慎使用）：

database.purgeLocalCache()

Firebase RTDB暂不支持单独清除单个节点缓存，精细控制需结合Source.SERVER查询方式。

3. 排查无回调问题 #

若离线且无缓存时无回调，检查以下两点：

• 确认所有Listener已正确注册，未被意外取消；
• 尝试替换get()为addListenerForSingleValueEvent，部分场景下该API回调触发更稳定：

ref.addListenerForSingleValueEvent(object : ValueEventListener {
    override fun onDataChange(snapshot: DataSnapshot) {
        // 处理数据（有缓存则返回缓存）
    }

    override fun onCancelled(error: DatabaseError) {
        // 处理离线等错误
    }
})

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