Node.js循环导入问题：调用function2时出现类型错误

这是典型的Node.js模块循环引用问题，我来给你拆解原因和解决办法：

问题根源：模块加载的时序问题 #

当你运行node testing/x.js时，Node.js的模块加载流程是这样的：

1. 启动加载x.js，先创建一个空的module.exports对象。
2. x.js第一行执行require('./y')，转而加载y.js。
3. y.js同样先创建空的module.exports，然后执行require('./x')——这时候x.js还没执行完（还没到module.exports={function2}这一步），所以y.js拿到的x模块导出是空对象，也就是function2是undefined。
4. y.js继续定义function1并导出，回到x.js的执行流程。
5. x.js定义function2并调用它：先打印from function 2 ，然后调用function1。
6. function1执行打印hello from function1，接着尝试调用function2——但y.js里的function2还是undefined，于是抛出TypeError: function2 is not a function。

可行的解决方法 #

方法1：调整导出与调用的顺序，延迟执行 #

把function2的调用放到模块导出之后，并用延迟执行的方式让模块加载完成后再触发：

// x.js
const { function1 } = require('./y');
const function2 = () => {
  console.log('from function 2 ');
  function1()
};
// 先导出，再延迟调用
module.exports = { function2 };
setImmediate(() => {
  function2();
});

这样等所有模块都加载完成后，y.js里引用的x模块导出已经包含了function2，调用时就不会出错了。

方法2：重构代码，彻底避免循环引用 #

最稳妥的方式是把互相依赖的逻辑抽离到第三方模块，消除循环：

// z.js（新增的公共模块）
// 用对象存储函数引用，实现延迟绑定
const refs = {
  function1: null,
  function2: null
};

exports.setFunction1 = (fn) => refs.function1 = fn;
exports.setFunction2 = (fn) => refs.function2 = fn;
exports.callFunction1 = () => refs.function1();
exports.callFunction2 = () => refs.function2();

修改x.js：

// x.js
const { setFunction2, callFunction1 } = require('./z');
const function2 = () => {
  console.log('from function 2 ');
  callFunction1();
};
setFunction2(function2);
module.exports = { function2 };
function2();

修改y.js：

// y.js
const { setFunction1, callFunction2 } = require('./z');
const function1 = () => {
  console.log('hello from function1');
  callFunction2();
};
setFunction1(function1);
module.exports = { function1 };

这种方式彻底斩断了循环依赖，代码逻辑也更清晰。

方法3：利用对象引用特性，动态添加导出属性 #

Node.js的module.exports是对象引用，我们可以先导出空对象，后续再给它添加属性：

// x.js
// 先导出空对象
module.exports = {};
const { function1 } = require('./y');
const function2 = () => {
  console.log('from function 2 ');
  function1()
};
// 动态添加属性
module.exports.function2 = function2;
function2();

// y.js
// 先导出空对象
module.exports = {};
const { function2 } = require('./x');
const function1 = () => {
  console.log('hello from function1');
  // 因为是对象引用，x后续添加的function2会同步过来
  function2();
};
module.exports.function1 = function1;

这种方式不需要额外模块，但本质还是依赖模块加载的引用特性，适合简单场景。

内容的提问来源于stack exchange，提问作者Satyam Tiwari