Firebase实时数据库对接Cloud Firestore遇导入错误，在线状态同步失败

问题根源 #

你参考的文档采用Firebase旧版命名空间写法（如firebase.firestore()），但你的项目使用的是Firebase v9+模块化API，因此会出现firebase未定义的错误，需改用模块化的导入与调用方式。

修正后的完整代码 #

结合你已有的db（Firestore实例）、dbt（实时数据库实例）和用户对象，修改后的代码如下：

import { auth, db, dbt } from "@/firebase/firebase";
import { ref as rtdbRef, set, onValue, onDisconnect } from "firebase/database";
import { doc, updateDoc, serverTimestamp } from "firebase/firestore";

// 监听实时数据库的连接状态
const connectedRef = rtdbRef(dbt, ".info/connected");
// 实时数据库中存储用户在线状态的节点
const myConnectionsRef = rtdbRef(dbt, `status/${user.uid}`);
// Firestore中对应用户文档的引用（假设用户数据存在users集合下，以uid为文档ID）
const userFirestoreRef = doc(db, "users", user.uid);

onValue(connectedRef, async (snap) => {
  if (snap.val() === false) {
    // 离线时直接更新Firestore的isOnline为false
    await updateDoc(userFirestoreRef, {
      isOnline: false,
      lastChanged: serverTimestamp()
    });
    return;
  }

  // 设置断开连接时的操作：实时数据库标记为disconnected，同时更新Firestore的isOnline为false
  await onDisconnect(myConnectionsRef).set("disconnected");
  await onDisconnect(myConnectionsRef).runTransaction(async () => {
    await updateDoc(userFirestoreRef, {
      isOnline: false,
      lastChanged: serverTimestamp()
    });
  });

  // 在线时更新实时数据库状态，同时更新Firestore的isOnline为true
  await set(myConnectionsRef, "connected");
  await updateDoc(userFirestoreRef, {
    isOnline: true,
    lastChanged: serverTimestamp()
  });
});

关键修正点说明 #

• 导入模块化API：新增Firestore的doc、updateDoc、serverTimestamp方法，替换旧的命名空间调用
• 复用已有实例：直接使用你已初始化好的db（Firestore）和dbt（实时数据库）实例，无需重新调用firebase.firestore()或firebase.database()
• 同步Firestore字段：通过updateDoc直接修改用户文档的isOnline字段，同时添加lastChanged记录状态变更时间（可选，用于显示最后上线时间）
• 离线逻辑优化：监听连接状态为false时立即更新Firestore，同时通过onDisconnect确保客户端意外断开时也能触发离线状态更新
• 异步处理：使用async/await处理异步操作，避免回调嵌套

注意事项 #

• 确保Firestore的users集合中存在对应用户的文档，且已有isOnline字段（布尔类型），若没有可在注册时初始化该字段为false
• 实时数据库的status节点需配置安全规则，确保只有用户自己能修改自己的状态节点，示例规则：

{
  "rules": {
    "status": {
      "$uid": {
        ".read": "auth != null",
        ".write": "auth.uid === $uid"
      }
    }
  }
}

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