Node.js升级至16后Firebase出现循环依赖下的'db'属性警告问题

问题根源 #

Node.js 14之后对CommonJS模块的循环依赖检测更严格。当项目存在循环引用（比如模块A引用admin.js，admin.js又间接引用模块A）时，模块加载阶段module.exports还未完全生成，此时访问db属性就会触发该警告——虽然实际运行时db已完成初始化，功能不受影响，但日志警告会影响整洁度。

可行解决方法 #

1. 延迟加载获取DB实例 #

修改admin.js，将db改为通过函数返回，避免模块加载时直接访问未完全初始化的导出属性：

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

admin.initializeApp();

module.exports = {
  admin,
  getDb: () => admin.firestore()
};

后续在其他模块中使用时：

const { admin, getDb } = require('./admin');
// 需要用到DB时再调用函数获取实例
const db = getDb();

2. 定位并消除循环依赖 #

执行以下命令定位循环依赖的具体模块：

node --trace-warnings index.js

根据输出找到互相引用的模块对，调整代码结构——比如将两个模块共享的逻辑抽成独立模块，打破循环引用链，从根源解决问题。

3. 切换到ES模块 #

将项目改为ES模块模式：要么把文件后缀改为.mjs，要么在package.json中添加"type": "module"。ES模块对循环依赖的处理逻辑与CommonJS不同，大概率能避开该警告。

修改后的admin.js（ES模块格式）：

import admin from 'firebase-admin';

admin.initializeApp();
const db = admin.firestore();

export { admin, db };

index.js（ES模块格式）：

import { admin, db } from './admin.js';

4. 调整导出顺序（极端场景尝试） #

如果上述方法无效，可尝试拆分导出步骤，确保初始化完成后再挂载db到exports：

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

admin.initializeApp();

// 先导出admin
module.exports.admin = admin;
// 初始化完成后再导出db
module.exports.db = admin.firestore();

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