Node.js/Express报错：Router.use()需传入中间件函数却得到对象

我之前也踩过这个坑，大概率是你的路由模块导出逻辑、或者路由与控制器的关联方式出了问题。下面给你梳理几种最常见的原因和解决办法：

1. 路由模块没有正确导出Express Router实例 #

这是最普遍的问题——你创建了Router，但没把它作为模块的导出值传出去：

// 错误示例：只创建Router却没导出
const express = require('express');
const router = express.Router();

router.get('/posts', (req, res) => { /* ... */ });

// 这里缺少关键的导出语句！

正确的做法是在路由文件末尾明确导出Router实例：

// 正确示例
const express = require('express');
const router = express.Router();

router.get('/posts', (req, res) => { /* ... */ });

module.exports = router; // 必须导出Router对象，app.use才能识别

2. 控制器引用方式错误：传了对象而非处理函数 #

如果你的路由依赖外部控制器，很可能是你把整个控制器对象直接传给了路由方法，而不是指定具体的处理函数：

// 控制器文件（postController.js）
module.exports = {
  getPosts: (req, res) => { /* ... */ },
  createPost: (req, res) => { /* ... */ }
};

// 错误的路由用法：直接传整个控制器对象
const postController = require('../controllers/postController');
router.get('/posts', postController); // 这里传的是对象，不是函数

// 正确用法：指定控制器里的具体方法
router.get('/posts', postController.getPosts);

另外还要检查控制器方法的格式：必须是(req, res, next)结构的函数，如果方法返回非函数值（比如异步函数没正确处理、或者返回了Promise却没包装成中间件），也会触发这个错误。

3. 模块系统混用导致导出/导入不匹配 #

如果你的项目混合使用了CommonJS（Node.js默认）和ES模块语法，会导致导入的不是Router实例，而是一个包装对象：

// 路由文件用ES模块导出
export default router;

// app.js用CommonJS的require导入，此时得到的是{ default: router }
const postRoutes = require('./routes/posts');
app.use('/posts', postRoutes); // 这里传的是包装对象，不是Router实例

解决办法：

• 统一模块系统：要么全用CommonJS（module.exports/require），要么在package.json里设置"type": "module"后全用ES模块语法
• 混合使用时手动取.default：const postRoutes = require('./routes/posts').default;

4. app.use()传入了错误的参数 #

比如你在主文件里错误地引用了路由模块的某个属性，而非Router实例本身：

const postRoutes = require('./routes/posts');
app.use('/posts', postRoutes.someWrongProperty); // 这个属性不是函数/ Router实例

可以在导入后打印一下路由模块，确认它是Express Router实例：

const postRoutes = require('./routes/posts');
console.log(postRoutes); // 正常应该输出类似[Function: router]的Router对象

5. 控制器架构问题：导出了类实例而非函数 #

如果你的控制器用类封装，却直接导出了类实例，路由里引用时就会传对象而非函数：

// 错误示例
class PostController {
  getPosts(req, res) { /* ... */ }
}
module.exports = new PostController(); // 导出的是实例对象

// 正确用法1：用静态方法
class PostController {
  static getPosts(req, res) { /* ... */ }
}
module.exports = PostController;
// 路由里用：router.get('/posts', PostController.getPosts);

// 正确用法2：直接导出方法对象
module.exports = {
  getPosts: (req, res) => { /* ... */ }
};

建议你先从检查路由文件的导出语句入手，再逐步排查控制器的引用方式，一般就能定位问题。

内容的提问来源于stack exchange，提问作者alt-rock