firebase-admin ^9.11.1调用get()报Client is offline但网络正常如何解决？

问题原因 #

1. Firebase Admin 未完成初始化就发起数据库请求：你在 FirebaseManager 的构造函数中直接调用异步的 .get() 方法，但没有保证 Firebase Admin 已经完成初始化、与 Realtime Database 建立连接，客户端未完成握手时发起请求就会触发离线错误。
2. 初始化参数缺失：如果初始化 Firebase Admin 时没有正确配置 databaseURL 参数，数据库客户端不知道目标连接地址，也会判定为离线状态。
3. 9.x 版本 get() 方法的逻辑限制：firebase-admin@9.x 的 Realtime Database get() 方法会优先读取本地离线缓存，当检测到连接未建立时不会等待重试，直接抛出客户端离线错误。

解决方案 #

步骤1：确保 Firebase Admin 提前完成正确初始化 #

在实例化 FirebaseManager 之前，必须先完成 Admin SDK 的初始化，且必须传入正确的 databaseURL 配置：

import * as admin from "firebase-admin";
import serviceAccount from "./你的服务账户密钥文件路径.json";

admin.initializeApp({
  credential: admin.credential.cert(serviceAccount as admin.ServiceAccount),
  // 替换为你自己项目的 Realtime Database 地址，格式为 https://<项目ID>.firebaseio.com
  databaseURL: "https://your-project-id.firebaseio.com"
});

步骤2：改造异步初始化逻辑 #

不要在构造函数中执行异步请求，将初始化逻辑抽为单独的异步方法，调用时等待初始化完成：

import * as admin from "firebase-admin";
import DataModel from "../types/firebase";

export class FirebaseManager {
  db: admin.database.Database;
  private isInitialized = false;

  constructor() {
    if (admin.apps.length === 0) {
      throw new Error("Firebase Admin 未初始化就创建 FirebaseManager 实例");
    }
    this.db = admin.database();
    if (!this.db) {
      throw new Error("cannot find database");
    }
  }

  async init(): Promise<void> {
    if (this.isInitialized) return;
    try {
      // 也可以用 once('value') 替代 get()，兼容性更好，会等待连接建立完成再返回
      const snapshot = await this.db.ref('/').once('value');
      if (!snapshot.exists()) {
        throw new Error("no database found :(");
      }
      const castedData = snapshot.val() as DataModel;
      console.log("Database successfully initialised!");
      this.isInitialized = true;
    } catch (err) {
      throw new Error(`初始化失败: ${(err as Error).message}`);
    }
  }
}

步骤3：正确调用初始化流程 #

// 先完成 Admin 初始化后再实例化
const firebaseManager = new FirebaseManager();
// 等待初始化完成再执行后续数据库操作
await firebaseManager.init();

可选：强制重置连接状态 #

如果仍然报错，可以在初始化 Admin 后主动强制客户端上线，重置连接状态：

admin.database().goOnline();
// 也可以先强制下线再上线清理状态
// admin.database().goOffline();
// admin.database().goOnline();

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