使用Firebase模拟器运行Jest测试时无法获取Database URL

你遇到的问题很典型：虽然firebase emulators:exec 'jest'会在运行测试时设置模拟器相关的环境变量，但firebase-admin默认不会自动读取这些变量来调整初始化配置——它还是会尝试使用生产环境的项目配置，而模拟器环境下没有正确指向数据库模拟器的URL，所以才会报错。

下面是几种可行的解决方案，按推荐程度排序：

1. 使用firebase-functions-test自动配置（推荐） #

这个库是Firebase官方提供的测试工具，能自动帮你把firebase-admin的配置指向正在运行的模拟器，无需手动拼接URL。

步骤： #

• 首先安装依赖：

  npm install --save-dev firebase-functions-test
  

• 修改你的测试文件：

  // 初始化测试工具，它会自动配置admin指向模拟器
  const test = require('firebase-functions-test')();
  const admin = require('firebase-admin');
  
  it("tests", async () => {
    // 现在可以直接操作模拟器的数据库了
    await admin.database().ref('foo').set("bar");
    // 这里添加你的断言逻辑，比如读取数据验证是否设置成功
    const value = await admin.database().ref('foo').once('value');
    expect(value.val()).toBe("bar");
  });
  
  // 测试完成后清理资源
  after(() => {
    test.cleanup();
  });
  

2. 手动读取环境变量配置admin #

如果你不想额外安装依赖，可以手动读取firebase emulators:exec设置的环境变量，来指定数据库模拟器的URL：

const admin = require('firebase-admin');

// 检查是否处于模拟器环境
if (process.env.FIREBASE_DATABASE_EMULATOR_HOST) {
  const [host, port] = process.env.FIREBASE_DATABASE_EMULATOR_HOST.split(':');
  // GCLOUD_PROJECT是exec自动设置的项目ID环境变量
  admin.initializeApp({
    databaseURL: `http://${host}:${port}?ns=${process.env.GCLOUD_PROJECT}`
  });
} else {
  // 生产环境使用默认初始化方式
  admin.initializeApp();
}

it("tests", async () => {
  await admin.database().ref('foo').set("bar");
  // 你的测试逻辑
});

3. 硬编码模拟器URL（不推荐） #

如果只是临时测试，也可以直接硬编码模拟器的URL，但这种方式不够灵活，换环境或者修改模拟器端口后需要手动调整：

const admin = require('firebase-admin');

admin.initializeApp({
  databaseURL: "http://localhost:9000?ns=your-project-id"
});

// 测试代码...

补充说明 #

firebase emulators:exec会自动设置以下关键环境变量，你可以在测试中打印process.env查看：

• FIREBASE_DATABASE_EMULATOR_HOST：数据库模拟器的地址和端口
• GCLOUD_PROJECT：你的Firebase项目ID
• FIREBASE_AUTH_EMULATOR_HOST：认证模拟器地址（如果用到的话）

但firebase-admin本身没有内置的模拟器检测逻辑，所以必须手动配置才能指向模拟器资源。

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