如何避免Node.js中require模块生成多实例？函数重复执行求助

这个问题其实是Node.js模块加载机制里常见的小坑，我来帮你拆解一下原因和解决办法：

先搞懂核心：Node.js模块是单例的 #

首先要明确：Node.js默认会缓存已经加载过的模块，只要你require的路径完全一致，模块只会被加载一次，不会生成多个实例。那为什么你会遇到函数执行两次的情况？大概率是下面两个原因之一：

1. 模块引入的路径不一致 #

比如：

• 在socket.js里你写的是require('./mining.js')
• 但在woodcutting.js里写的是require('../mining.js')（假设文件目录层级不同）
  或者文件名大小写不一致（比如require('./Mining.js')和require('./mining.js')，Linux系统下会被视为不同路径）

这种情况下，Node.js会把它们当成两个不同的模块，分别加载两次，自然会触发两次函数执行。

2. mining.js里有顶层自执行的代码 #

如果你的mining.js里直接写了generateOre()（不是导出后让调用方调用），比如：

// mining.js 错误写法
function generateOre() {
  console.log("生成矿石");
}
// 顶层直接执行，模块加载时就会跑
generateOre();
module.exports = { generateOre };

那每次加载这个模块（不管是不是重复加载），这段顶层代码都会执行一次。如果因为路径问题加载了两次，函数就会执行两次。

具体解决办法 #

第一步：统一所有模块的引入路径 #

检查所有引入mining.js的文件，确保路径完全一致：

• 统一使用相对路径（比如都用./mining.js，或者根据目录层级统一写../mining.js）
• 统一文件名的大小写（尤其是在Linux/macOS环境下）
• 建议都加上.js后缀，避免Node.js自动查找文件时出现歧义

第二步：重构mining.js，避免顶层副作用 #

把mining.js里的业务逻辑调用移到调用方，只导出需要的函数和变量：

// mining.js 正确写法
// 定义需要共享的变量
let totalOre = 0;

// 定义需要导出的函数
function generateOre() {
  totalOre++;
  console.log(`生成了1块矿石，总数：${totalOre}`);
  return totalOre;
}

// 只导出需要外部访问的内容
module.exports = {
  generateOre,
  totalOre
};

第三步：在调用方统一触发执行 #

比如在socket.js里：

// socket.js
const mining = require('./mining.js');
const woodcutting = require('./woodcutting.js');

// 这里只需要调用一次，就只会执行一次
mining.generateOre();

而woodcutting.js里如果只是引入mining.js但不调用generateOre()，就不会触发额外的执行。

额外排查点 #

如果上面的方法还没解决问题，可以检查：

• 是否在代码中使用了delete require.cache[require.resolve('./mining.js')]这类清除缓存的代码，这会导致模块被重新加载
• 是否使用了第三方模块加载器（比如webpack），可能会改变模块加载逻辑，但Node.js原生环境下不会有这个问题

内容的提问来源于stack exchange，提问作者Otto Määnpää