Firebase RTDB离线模式：优先从缓存读取数据

Firebase RTDB SDK默认读取逻辑是先尝试请求云端，失败后才会 fallback 到本地缓存，这就是你离线时遇到5-7秒延迟的原因。要改成优先读缓存，有两种实用方案：

1. 强制指定读取来源（Web SDK v9+） #

调用get方法时，通过source参数直接指定读取本地缓存，缓存无数据时再主动请求云端：

import { get, ref } from "firebase/database";

const targetRef = ref(db, 'your-node-path');
// 优先读取本地缓存
const cacheSnapshot = await get(targetRef, { source: 'cache' });
if (cacheSnapshot.exists()) {
  console.log('使用缓存数据:', cacheSnapshot.val());
} else {
  // 缓存为空时再请求云端
  const cloudSnapshot = await get(targetRef, { source: 'server' });
  console.log('使用云端数据:', cloudSnapshot.val());
}

source参数的三个可选值：

• cache：仅读取本地缓存，无数据直接返回空快照
• server：强制请求云端，离线状态下会请求失败
• default：SDK默认逻辑，先尝试云端再 fallback 到缓存

2. 实时监听时区分缓存/云端数据 #

如果用onValue做实时监听，SDK会先触发本地缓存的快照，之后再同步云端数据。你可以通过快照的fromCache属性判断来源，优先处理缓存数据：

import { onValue, ref } from "firebase/database";

const targetRef = ref(db, 'your-node-path');
onValue(targetRef, (snapshot) => {
  if (snapshot.fromCache) {
    // 离线状态下只会触发这个分支，直接用缓存数据
    console.log('来自缓存:', snapshot.val());
  } else {
    // 在线状态下会触发这个分支，拿到云端最新数据
    console.log('来自云端:', snapshot.val());
  }
});

配合你已经设置的keepSynced(true)，在线时缓存会和云端保持同步，离线时就是最后一次同步的状态，完全能满足离线优先的需求。

另外需要注意，iOS、Android等其他平台的SDK也有对应配置，比如Android端可以用CacheServerPriority.CACHE_FIRST实现类似逻辑，核心都是强制指定读取优先级。

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