Firebase Realtime Database本地模拟器异常，函数无法读取数据

问题场景 #

开发Firebase Functions时，搭配Functions和Realtime Database模拟器，捕获/users/{userId}/games/{gamesId}/lastScore字段更新事件后，查询/users/{userId}返回null；直接访问127.0.0.1:9000/users.json也返回null。

解决步骤 #

1. 确认模拟器数据库存在测试数据 #

本地模拟器启动后会创建全新的空数据库，不会同步线上数据，必须手动写入测试数据：

• 通过Firebase Emulator UI（默认地址http://localhost:4000）的Realtime Database面板添加数据；
• 或使用curl命令快速写入：

  curl -X PUT -d '{"test-user-id": {"name": "测试用户", "games": {"game001": {"lastScore": 150}}}}' http://127.0.0.1:9000/users.json
  

写入后重新访问127.0.0.1:9000/users.json，确认数据返回正常。

2. 强制Admin SDK连接本地模拟器 #

默认Admin SDK会尝试连接线上数据库，需显式配置指向本地模拟器：
修改index.ts的Admin初始化代码，二选一即可：

• 通过环境变量指定：

  const admin = require("firebase-admin");
  
  // 配置连接到本地数据库模拟器
  process.env.FIREBASE_DATABASE_EMULATOR_HOST = "127.0.0.1:9000";
  admin.initializeApp();
  const db = admin.database();
  

• 或初始化时指定databaseURL（注意替换为你的instance名称）：

  const admin = require("firebase-admin");
  
  admin.initializeApp({
    databaseURL: "http://127.0.0.1:9000/?ns=my-instance"
  });
  const db = admin.database();
  

这里的ns参数必须与firebase.json中database.instance的my-instance完全匹配。

3. 确保函数等待异步操作完成 #

当前代码中数据库查询是异步操作，但函数未等待其完成就终止，会导致查询被中断或日志不完整。修改为async函数并等待异步操作：

export const updateLeaderboard = onValueUpdated(
  { ref: `/users/{userId}/games/{gamesId}/lastScore` },
  async (event: any) => {
    const userId = event.params.userId;
    console.log(event.params);

    // 等待数据库查询完成
    const snapshot = await db.ref(`/users/${userId}`).get();
    const user = snapshot.val();
    console.log(user);

    return null; // 返回Promise标记函数执行完成
  }
);

4. 验证模拟器启动状态 #

确保使用firebase emulators:start启动所有模拟器，查看控制台输出：

• 确认Realtime Database模拟器正常启动在9000端口；
• 检查是否有Database Emulator logging to database-debug.log的启动日志，无报错信息。

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