commonjs循环引用静默返回未初始化module.exports，导致typeerror或undefined；需通过console日志观察加载顺序（如a→b→a）、检查require.cache中路径异常，并逆向追踪require调用链定位闭环模块。
CommonJS 循环引用不会报明确错误，而是静默返回未初始化完的 module.exports，导致调用时出现 TypeError: xxx is not a function 或读取属性为 undefined。排查关键不在代码结构图，而在运行时加载顺序和模块状态。
加日志观察模块加载顺序
在每个疑似参与循环的模块顶部插入：
-
console.log('loading', module.id)—— 看是否出现a → b → a这样的重复路径 -
console.log(module.id, 'exports:', Object.keys(module.exports))—— 对比哪个模块被require时exports还是空对象（[]）
检查 require.cache 确认加载状态
启动程序后，在 VSCode 的开发者工具（Ctrl+Shift+P → Developer: Toggle Developer Tools）中执行：
-
Object.keys(require.cache)查看已加载模块路径，找重复出现或顺序异常的文件 - 结合日志输出，确认是否某个模块被多次加载、或早于其依赖完成初始化就被引用
定位到具体 require 调用链
不要只看报错行，要逆向追踪：
- 从报错位置向上翻，找到最早出现相互
require()的两个文件（比如 A require B，B 又 require A） - 注意：VSCode 的“跳转到定义”不可靠，它只解析字符串路径，不反映实际运行时加载行为
验证是否真为 CommonJS 循环而非其他问题
区分典型表现：
- 如果是循环引用，通常伴随
undefined方法调用、配置项为空、但进程仍能响应 Ctrl+C - 若进程完全卡死、CPU 先飙高后归零、新请求无响应，则更可能是异步互锁或阻塞调用，不是 CommonJS 循环
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
