Node.js / 系统课时
拆分 Router 模块
拆分 Router 模块
当所有接口都堆在 app.js 中时,资源增多后很难定位路径和参数处理。Express 的 Router 可以把用户、商品等资源拆成独立模块,由入口文件统一挂载;最终 URL 由挂载前缀与 Router 内路径共同组成。
学习目标
- 用
express.Router()按业务资源拆分路由文件。 - 正确理解
app.use()挂载前缀与模块内路径的拼接关系。 - 识别父级路径参数、404 和全局中间件在模块化后的边界。
按业务资源划分 Router
拆分时优先按资源或业务域分文件,而不是按 GET、POST 等 HTTP 方法分文件。一个常见小型 API 可以保留 app.js 作为组合入口,再建立 routes/users.js 与 routes/products.js;用户相关的查询和创建都留在 users Router,商品相关接口都留在 products Router。

入口文件只负责全局中间件、Router 挂载和最终兜底处理,具体资源路径由各 Router 自己维护。这样新增 /api/users/:id 时只需要修改 users 模块,不必在一个长入口文件里寻找插入位置。
把路由拆成独立模块
下面三个文件共同组成一个可运行项目,单个文件不是独立程序,因此分别标注为片段示例。项目已安装 express,目录中包含 app.js 和 routes 目录。
片段示例:routes/users.js,负责用户资源。
const express = require('express');
const router = express.Router();
// 示例数据固定在内存中,便于只关注 Router 拆分方式。
const users = [
{ id: '1', name: 'Ada' },
{ id: '2', name: 'Lin' }
];
router.get('/', (req, res) => {
res.json(users);
});
router.get('/:id', (req, res) => {
// 模块内只声明相对路径,资源前缀由 app.js 挂载。
const user = users.find((item) => item.id === req.params.id);
if (!user) {
return res.status(404).json({ error: 'user not found' });
}
res.json(user);
});
module.exports = router;片段示例:routes/products.js,负责商品资源。
const express = require('express');
const router = express.Router();
// 商品资源与用户资源互不共享路由定义。
const products = [
{ id: 'p1', name: 'Keyboard' }
];
router.get('/', (req, res) => {
res.json(products);
});
module.exports = router;片段示例:app.js,只组合全局能力和各 Router。
const express = require('express');
const usersRouter = require('./routes/users');
const productsRouter = require('./routes/products');
const app = express();
// 所有资源都依赖的中间件放在 Router 挂载之前。
app.use(express.json());
app.use('/api/users', usersRouter);
app.use('/api/products', productsRouter);
// 资源 Router 都未响应时,最后统一返回 404。
app.use((req, res) => {
res.status(404).json({ error: 'not found' });
});
app.listen(3000, () => {
console.log('listening on 3000');
});预期结果:运行 node app.js 后,执行 curl -s http://localhost:3000/api/users/1,第一条命令输出:
{"id":"1","name":"Ada"}再执行 curl -s http://localhost:3000/api/products,第二条命令输出:
[{"id":"p1","name":"Keyboard"}]挂载前缀和模块内路径一起决定 URL
Router 内不要重复写已经在 app.use() 中声明的资源前缀。若 users Router 已挂载到 /api/users,模块内再写 /api/users/:id 会得到重复路径 /api/users/api/users/:id,这是拆分时最常见的路径错误之一。
app.use() 挂载前缀 |
Router 内路径 | 实际请求路径 |
|---|---|---|
/api/users |
/ |
/api/users |
/api/users |
/:id |
/api/users/1 |
/api/products |
/ |
/api/products |
调试模块化路径时,先检查入口的挂载前缀,再检查 Router 内部路径,不要只盯着浏览器或客户端报出的 404。只要这两段拼接后的结果与请求 URL 不一致,路由就不会命中。
处理父级参数与模块边界
如果挂载路径本身带参数,例如 /api/teams/:teamId/users,子 Router 默认不会保留父级的 teamId。需要在子模块创建 Router 时使用 express.Router({ mergeParams: true }),这样模块内的处理器才能读取 req.params.teamId;当父子路径使用同名参数时,子级值优先。
模块化之后仍要保持顺序:express.json() 这类所有 Router 都依赖的全局中间件放在挂载之前,资源专用中间件放进对应 Router,最终 404 放在所有 Router 之后。入口文件因此可以稳定保持“全局能力 → 资源挂载 → 兜底处理”三段,而每个 Router 只维护自己的路径和规则。