Node.js Express路由异常求助：路由初始化与挂载错误排查

问题场景 #

使用Express框架时路由无法正常工作，同时WebStorm中代码高亮显示异常。

文件结构 #

server/
├── index.js
└── routes/
    ├── index.js
    ├── deviceRouter.js
    ├── brandRouter.js
    ├── typeRouter.js
    └── userRouter.js

核心错误与修复方案 #

1. Router模块导入错误（导致WebStorm显示异常） #

在/server/routes/index.js中，当前导入代码：

const Router = require('express');
const router = Router();

错误原因：require('express')返回的是Express主模块对象，而非Router构造函数，直接调用会触发类型错误，同时IDE无法正确识别Router类型，导致显示异常。

修复代码：

const { Router } = require('express'); // 解构获取Router构造函数
const router = Router();

修复后WebStorm会正确识别Router类型，显示为预期样式。

2. 路由挂载语法错误 #

在/server/routes/index.js最后一行：

router.use = router.use('/device', deviceRouter);

错误原因：这行代码将router.use()的返回值（router实例）重新赋值给router.use方法，直接覆盖了Express内置的use方法，导致后续路由无法正常挂载。

修复代码：

router.use('/device', deviceRouter); // 移除多余的赋值操作

3. 路由模块导入路径错误 #

在server/index.js中：

const router = require('routes/index')

错误原因：使用非相对路径时，Node.js会优先从node_modules目录查找模块，无法找到自定义的routes/index模块。

修复代码：

const router = require('./routes/index') // 使用相对路径导入自定义模块

修复后的完整代码示例 #

/server/routes/index.js #

const { Router } = require('express');
const router = Router();

const deviceRouter = require('./deviceRouter');
const brandRouter = require('./brandRouter');
const typeRouter = require('./typeRouter');
const userRouter = require('./userRouter');

router.use('/user', userRouter);
router.use('/type', typeRouter);
router.use('/brand', brandRouter);
router.use('/device', deviceRouter);

module.exports = router;

server/index.js #

const express = require('express');
const app = express();
const router = require('./routes/index');

// 挂载路由到根路径
app.use('/', router);

// 启动服务示例
app.listen(3000, () => {
  console.log('Server running on port 3000');
});

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