Google Firestore连接断开且无法自动重连问题咨询

问题描述 #

控制台和LogRocket中持续收到Firestore Listen接口的请求失败错误，已有数千条记录。询问是否需要手动处理重连，或是可通过JavaScript SDK配置自动重连？

相关代码如下：

const useProductAmmendments = (dispatch, clientId: string) => { 
  useEffect(() => { 
    async function fetch() { 
      const modifierGroupsQuery = query(collection(getFirestore(), `${clientId}/products/modifierGroups`), where("enabled", "==", true)); 
      const additionGroupsQuery = query(collection(getFirestore(), `${clientId}/products/additionGroups`), where("enabled", "==", true)); 
      const preparationGroupsQuery = query(collection(getFirestore(), `${clientId}/products/preparationGroups`), where("enabled", "==", true)); 
      const upsellGroupsQuery = query(collection(getFirestore(), `${clientId}/products/upsellGroups`), where("enabled", "==", true)); 

      const [snap1, snap2, snap3, snap4] = await Promise.all([getDocs(modifierGroupsQuery), getDocs(additionGroupsQuery), getDocs(preparationGroupsQuery), getDocs(upsellGroupsQuery)]); 

      dispatch( 
        setProductAmmendments({ 
          modifierGroups: snap1.docs.map((d) => ({ id: d.id, ...d.data() })), 
          additionGroups: snap2.docs.map((d) => ({ id: d.id, ...d.data() })), 
          preparationGroups: snap3.docs.map((d) => ({ id: d.id, ...d.data() })), 
          upsellGroups: snap4.docs.map((d) => ({ id: d.id, ...d.data() })), 
        }) 
      ); 
    } 
    fetch(); 
  }, []); 

解答 #

1. 当前代码不会触发Listen接口请求 #

你提供的代码使用的是getDocs()方法，这是一次性读取数据的操作，不会建立持久化的长连接，因此这些Listen接口的失败错误和这段代码无关，需要排查项目中其他使用Firestore实时监听的逻辑。

2. Firestore JS SDK的自动重连机制 #

Firestore JavaScript SDK针对实时监听（onSnapshot()方法）内置了自动重连逻辑，无需手动配置：

• 当网络连接中断或Listen请求失败时，SDK会自动尝试重连，重连间隔会逐步递增（退避策略），直到恢复连接。
• 重连成功后，SDK会同步最新的数据变化，无需开发者手动处理。

3. 错误日志的可能原因与解决建议 #

（1）未正确移除实时监听器

如果项目中使用了onSnapshot()但未在组件卸载或不再需要时调用返回的unsubscribe函数，会导致无效的长连接残留，反复发起Listen请求并失败。
解决方案：在React的useEffect清理函数中移除监听器，示例：

useEffect(() => {
  const unsubscribe = onSnapshot(query, (snap) => {
    // 处理数据
  });
  // 组件卸载时移除监听器
  return unsubscribe;
}, [query]);

（2）SDK版本问题

旧版本的Firestore SDK可能存在重连逻辑的bug，导致不必要的失败日志。
解决方案：升级Firestore JS SDK到最新稳定版本。

（3）临时网络波动的正常重试日志

SDK在重连过程中会产生失败请求，但这些都是自动处理的临时错误，不会影响业务逻辑。LogRocket可能捕获了这些重试过程中的请求失败，但实际SDK已经完成了重连。
解决方案：如果不想在LogRocket中看到这些日志，可以通过LogRocket的过滤规则屏蔽Firestore Listen接口的错误；或确认没有残留的无效监听器后，忽略这些自动重试的失败记录。

内容的提问来源于stack exchange，提问作者Paul de Wit