为什么Express的Router()函数返回undefined导致app.use报错？

问题根源 #

你遇到的是Node.js 模块循环依赖问题，index.ts中console.log没有执行是最典型的特征：Node加载模块时遇到循环引用，会直接返回当前未完成初始化的exports对象（此时router还没完成定义，所以导入结果为undefined），不会继续执行被依赖模块的剩余代码。

你的场景触发循环依赖的典型路径为：expressInstance.ts从上层目录导入router，如果上层目录的index.ts、user.routes、post.routes任意一个文件中又反向导入了expressInstance相关内容，就会形成闭环，触发循环依赖逻辑。

排查&解决方案 #

快速验证 #

可以先安装madge工具扫描项目循环依赖：

npx madge --circular ./src

扫描结果会直接展示完整的循环依赖链路。

最通用的修复方案 #

调整路由注册逻辑的位置，避免在express实例初始化文件中导入上层模块：

1. 修改expressInstance.ts，移除路由导入和注册逻辑：

// expressInstance.ts
import express from "express";
import cors from "cors";

const expressInstance = express();

expressInstance.use(express.urlencoded({extended: false}));
expressInstance.use(express.json());
expressInstance.use(cors());

export { expressInstance };

2. 在服务启动文件server.ts中统一完成路由注册：

// server.ts
import { expressInstance } from "./utils/expressInstance";
import { router } from "./index";

expressInstance.use(router);
// 后续启动监听逻辑
expressInstance.listen(3000, () => {
  console.log("服务已启动，端口3000");
});

其他可选方案 #

• 如果路由模块需要用到express实例属性，不要直接导入expressInstance，改成通过请求对象的req.app访问，或者用依赖注入的方式传参，避免反向导入。
• 将路由合并逻辑从根目录index.ts迁移到独立的src/routes/index.ts文件，expressInstance.ts直接导入该路径下的router，规避目录层级导致的意外循环引用。

内容的提问来源于stack exchange，提问作者Nathan Murillo