Firebase RTDB set操作无限挂起（停滞在Buffering put）求助

从日志@firebase/database: p:0: Buffering put: /rooms/TDFE来看，请求被缓冲但未完成发送或确认，以下是具体排查方向：

1. 初始化环节验证 #

• 确认rtdb实例已正确初始化：必须先调用firebaseAdmin.initializeApp()，传入包含RTDB URL的完整配置，且服务账号具备databases.write权限。
• 排查初始化是否存在异步阻塞：如果初始化代码的Promise未等待就直接使用rtdb，会导致实例未就绪，请求被无限缓冲。

2. 网络与环境限制检查 #

• 验证运行环境能否访问Firebase RTDB域名（通常为*.firebaseio.com）：防火墙、代理或云服务商的网络策略可能拦截请求，导致缓冲的请求无法发送到服务器。
• 切换本地环境测试：排除生产环境网络规则的影响，确认请求本身的有效性。

3. 代码冗余Promise嵌套修复 #

当前函数存在不必要的Promise嵌套，roomRef.set()本身已返回Promise，冗余包裹可能导致状态通知失效，进而表现为挂起。修改后的代码如下：

// inserts room in realtime database
export async function insertRoom(roomCode, userID) {
  const now = Date.now();
  const ref = rtdb.ref('rooms');
  const roomRef = ref.child(roomCode);
  const roomObj = {
    gameID: "",
    creator: userID,
    created: now,
    lastActivity: now
  };
  try {
    await roomRef.set(roomObj);
    console.log('successfully saved data.');
  } catch (e) {
    console.error('Error saving data:', e);
    throw e;
  }
}

这种写法避免了嵌套导致的状态丢失，确保错误和成功信号能正确传递。

4. 实时数据库规则校验 #

检查RTDB安全规则，确认服务账号有权写入rooms/${roomID}路径。如果规则拒绝写入，请求可能静默挂起而非立即抛出错误。示例规则（确保服务账号可写入）：

{
  "rules": {
    "rooms": {
      "$roomID": {
        ".write": "auth != null"
      }
    }
  }
}

注意：服务账号访问时，规则中的auth会携带服务账号身份信息，需避免规则限制到特定用户ID而排除服务账号。

5. 依赖版本更新 #

检查firebase-admin包版本，旧版本可能存在连接或缓冲相关Bug，尝试升级到最新稳定版：

npm install firebase-admin@latest

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