Node.js跨目录require模块导出为空/undefined问题求助

目录结构 #

├── users/
│   ├── services.js
│   ├── index.js
│   └── otherThings.js
└── middlewares/
    ├── is-auth.js
    └── index.js

相关模块代码 #

users/services.js

exports.A = (a,b,c)=> { /* do something */ }
exports.B = (a,b,c)=> { /* do something */ }

users/index.js

const services= require('./services');
const otherThings= require('./otherThings');
module.exports = { otherThings, services};

middlewares/is-auth.js

const { services } = require('../users');
// services 为 undefined
const indexObject = require('../users')
console.log(indexObject) // 输出 {}

问题原因 #

这是Node.js模块循环引用导致的运行时加载异常。你的users/otherThings.js（或users目录下其他模块）大概率引用了middlewares/is-auth.js，形成了循环依赖链：
users/index.js → otherThings.js → middlewares/is-auth.js → users/index.js

Node.js处理循环引用时，会返回一个未完全初始化的模块对象（空对象{}）。而编辑器的代码提示是基于静态语法分析的，它只会解析文件的导出声明，不会考虑运行时的模块加载顺序，所以能正常给出services的代码提示，但运行时却拿不到内容。

解决方法 #

1. 直接导入目标模块 #

跳过users/index.js，直接导入services模块，避免触发循环引用的问题：

// middlewares/is-auth.js
const services = require('../users/services');
// 此时services可以正常获取A、B函数

2. 消除循环引用 #

重构代码拆分不必要的循环依赖：

• 把services里的核心逻辑抽成独立的无依赖模块，让users和middlewares都引用这个独立模块，而非互相引用整个目录。
• 检查users目录下的模块（比如otherThings.js），移除对middlewares模块的不必要引用。

3. 延迟导入 #

如果无法消除循环，将导入操作放在函数内部，延迟到需要使用时再加载模块：

// middlewares/is-auth.js
function useServices() {
  const { services } = require('../users');
  // 在这里使用services.A或services.B
}

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