Firebase Firestore SDK在Mocha+Chai单元测试环境下无法正常运行排查

核心问题原因 #

• 错误给describe函数添加了async修饰：Mocha的describe仅用于测试用例分组，本身不支持异步回调，添加async会打乱内部测试用例的异步逻辑调度，这是测试失败的核心原因。
• 配置参数拼写错误：初始化配置中的环境变量名FIREBASE_DATABASAE_URL拼写错误，正确应为FIREBASE_DATABASE_URL，拼写错误会导致数据库连接配置加载异常。
• 语法混用问题：如果测试用例使用async/await语法，无需额外添加done()回调，二者同时使用会导致Mocha无法正确识别测试完成状态。

修复后的代码示例 #

// 顶部初始化部分，先修正环境变量拼写
import { getFirestore } from 'firebase-admin/firestore';
import { initializeApp, applicationDefault } from 'firebase-admin/app';

// 如需使用本地模拟器，建议显式声明环境变量
process.env.FIRESTORE_EMULATOR_HOST = 'localhost:8080';

initializeApp({
  credential: applicationDefault(),
  databaseURL: process.env.FIREBASE_DATABASE_URL, // 修正拼写
});

// 测试部分去掉describe的async修饰
describe("example", function() {
  it("should write to Firestore in a mocha test", async function() {
    // 可按需设置单条用例超时
    this.timeout(10000);
    const db = getFirestore();
    const ref = db.collection('testCollection');
    await ref.doc('testDoc').set({test: true});
    // 可选添加断言验证写入结果
    const doc = await ref.doc('testDoc').get();
    expect(doc.exists).to.be.true;
  });
});

额外检查项 #

• 如果你使用ESM规范的import语法，需确保package.json中配置了"type": "module"，或者运行Mocha时添加--experimental-modules参数。
• 若使用本地Firestore模拟器，无需配置生产凭证，applicationDefault()在本地环境仍然有效，无需额外修改。

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