Express项目中导入导出的io时出现module.exports undefined问题

你遇到的是循环依赖的典型问题——当models/users.js尝试导入../index时，index.js还没完成导出流程，此时module.exports还是undefined。这是Node.js模块加载机制里的常见坑：模块在加载过程中被其他模块引用时，会返回当前未完成的导出对象。

问题根源拆解 #

代码的执行顺序大概是这样的：

1. Node.js开始加载index.js，先执行第三方依赖的导入，初始化app、Server，接着初始化io。
2. 在index.js还没执行到module.exports = { Server, io }这一行时，users.js通过const { io } = require('../index')引用了它，此时index.js的导出还未赋值，所以拿到的是undefined。

最佳解决方案：抽离Socket.io初始化逻辑 #

最干净的做法是把Socket.io的初始化单独放到独立文件中，彻底避免循环引用。

步骤1：创建socket.js文件

在server/目录下新建该文件，专门管理Socket.io实例：

const { Server } = require('http');
let ioInstance;

// 初始化Socket.io
function initSocket(server) {
  ioInstance = require('socket.io')(server);
  // 这里可以添加Socket.io事件监听逻辑（比如连接、断开）
  return ioInstance;
}

// 获取已初始化的io实例
function getIO() {
  if (!ioInstance) {
    throw new Error('Socket.io还未初始化，请先调用initSocket！');
  }
  return ioInstance;
}

module.exports = { initSocket, getIO };

步骤2：修改index.js

让index.js调用socket.js的初始化方法，不再直接在内部创建io：

const app = require('express')();
const Server = require('http').createServer(app);
const { initSocket } = require('./socket');

// 初始化Socket.io并获取实例
const io = initSocket(Server);

// 你的其他Express路由、中间件逻辑...

module.exports = { Server, io };

步骤3：修改models/users.js

现在从socket.js获取io实例，而非直接引用index.js：

const { getIO } = require('../socket');

// 示例：添加用户的函数
function addNewUser(userData) {
  // 这里写你的用户保存逻辑（比如存入数据库）
  
  // 获取io实例并发送事件
  const io = getIO();
  io.emit('new-user-added', userData);
}

module.exports = { addNewUser };

临时替代方案：延迟导入（不推荐长期使用） #

如果暂时不想重构代码，也可以在users.js里延迟导入io——不在文件顶部导入，而是在需要使用它的函数内部导入：

function addNewUser(userData) {
  // 只在需要时导入，此时index.js已完成导出
  const { io } = require('../index');
  io.emit('new-user-added', userData);
}

这种方法能快速解决问题，但代码不够优雅，若多个函数需要io会重复导入逻辑，所以更推荐第一种抽离文件的方案。

内容的提问来源于stack exchange，提问作者Shankar Regmi