Express Router报错：Router.use()需中间件函数却得到对象求助

错误原因 #

这个错误的核心是：你传递给Router.use()或app.use()的不是合法的Express中间件函数/路由实例，而是一个普通对象。绝大多数情况是路由模块（route.js）没有正确导出配置好的Express Router实例，或是导出了非Router类型的对象。

报错定位 #

报错信息里的抛出语句来自Express框架核心的router.js文件，具体行号随Express版本变化，但触发错误的根源是你server.js里的app.use('api/', router)这一行——因为这里传入的router不是有效的Router实例。

修复步骤 #

1. 修正route.js的导出逻辑 #

确保route.js正确创建并导出Router实例：

// routes/route.js
const express = require('express');
const router = express.Router();
const controller = require('../controller/controller');

// 示例：绑定路由与控制器方法
router.get('/fetch-data', controller.getDatabaseData);

// 关键：必须导出配置好的router实例
module.exports = router;

2. 修正server.js的路由引入与使用 #

确认路由模块引入路径正确，并且前缀格式合法：

// server.js
const express = require('express');
const app = express();
// 正确引入路由模块
const apiRouter = require('./routes/route');

// 注意前缀要以斜杠开头，正确写法是'/api'
app.use('/api', apiRouter);

app.listen(3000, () => {
  console.log('Server running on port 3000');
});

3. 验证控制器导出的合法性 #

确保controller.js导出的是可被路由调用的函数：

// controller/controller.js
const db = require('../db/db');
const queries = require('../query/queries.json');

// 导出控制器方法，确保是(req, res)格式的函数
exports.getDatabaseData = async (req, res) => {
  try {
    const queryResult = await db.query(queries.your_query_key);
    res.status(200).json(queryResult.recordset);
  } catch (error) {
    res.status(500).json({ error: error.message });
  }
};

常见避坑点 #

• 不要将普通对象当作Router实例导出，必须导出express.Router()创建的对象
• 路由前缀必须以/开头，避免出现app.use('api/', router)这种格式错误
• 检查模块引入路径，确保没有因路径错误引入了不存在的空对象或其他非Router对象

内容的提问来源于stack exchange，提问作者Prabir Choudhury