运行mocha测试时出现node端MongoError循环依赖警告 如何移除或解决
警告根因
这个提示属于Node.js 16+版本下的模块循环依赖兼容问题,和你的测试用例执行逻辑没有关联。
触发逻辑很简单:新版MongoDB官方驱动已经把顶层导出的MongoError属性移除了,但项目里安装的旧版依赖(一般是版本低于6.0的Mongoose,或者其他基于旧驱动开发的MongoDB相关工具),还在通过循环加载的模块链路尝试引用这个已经不存在的属性,就会打印该警告。因为不影响实际的数据库读写逻辑,所以你会看到测试用例能正常通过。
对应解决方式
- 优先升级MongoDB相关依赖到兼容版本
先执行npm ls mongoose mongodb查看本地安装的依赖版本:如果当前Mongoose版本低于6.0,直接升级到最新稳定版即可:npm install mongoose@latest
Mongoose 6.x及以上版本已经适配了新版MongoDB驱动的导出规则,升级后该警告会自动消失。 - 不想升级依赖的临时屏蔽方案
如果因为项目历史代码兼容问题暂时没法升级Mongoose,可以通过进程警告过滤逻辑,把这个已知的无影响提示从输出中移除:
在测试入口文件(比如test/bootstrap.js)的最顶部,加入如下过滤代码:
之后确保mocha启动时会加载这个入口文件,在process.on('warning', (warning) => { // 过滤已知的MongoError循环依赖无影响警告 if (warning.message.includes("Accessing non-existent property 'MongoError' of module exports inside circular dependency")) return; console.warn(warning.name, warning.message); });package.json的test脚本里加上加载参数即可:"test": "mocha --require ./test/bootstrap.js" - 兜底降级方案
如果上述两种方案都因为环境限制没法实施,可以把本地Node.js版本切换回14.x LTS版本,旧版Node.js对这类模块循环引用的检查逻辑更宽松,不会弹出该类提示。
注意:这个警告本身不影响测试执行、数据库操作的正确性,属于上游依赖的版本兼容遗留问题,不需要为了消警告随意修改业务代码里的错误捕获逻辑。
内容的提问来源于stack exchange,提问作者Mavrickj9
相关产品推荐
相关产品推荐

