在Node.js的Express应用开发中，路由是处理客户端请求的核心部分，当项目业务逐渐复杂时，路由文件会不断增多，相同的前置校验、数据处理逻辑也会重复出现在多个路由中，同时不同路由需要整合多个数据源返回结果时，代码会变得杂乱。路由聚合就是解决这类问题的有效方案，通过统一的路由管理结构，实现逻辑复用和数据高效整合。
路由聚合的核心思路
路由聚合的本质是将分散的路由模块按照业务维度归类，通过一个统一的入口文件管理所有路由，同时抽离多个路由共用的逻辑作为通用中间件，避免重复编写。对于需要整合多数据源的场景，可以在聚合层统一处理数据拉取和合并逻辑，让单个路由只关注自身的业务处理。
基础路由聚合实现
首先我们可以按照业务模块拆分路由文件，再通过主入口文件聚合所有路由。下面是一个用户模块和订单模块的路由拆分示例：
// routes/user.js 用户模块路由
const express = require('express');
const router = express.Router();
// 用户相关路由
router.get('/list', (req, res) => {
res.json({ code: 0, data: [{ id: 1, name: '张三' }] });
});
router.get('/detail/:id', (req, res) => {
res.json({ code: 0, data: { id: req.params.id, name: '张三' } });
});
module.exports = router;
// routes/order.js 订单模块路由
const express = require('express');
const router = express.Router();
// 订单相关路由
router.get('/list', (req, res) => {
res.json({ code: 0, data: [{ orderId: 1001, amount: 200 }] });
});
module.exports = router;
接下来通过主入口文件聚合这两个路由模块：
// app.js 主入口文件
const express = require('express');
const app = express();
const userRouter = require('./routes/user');
const orderRouter = require('./routes/order');
// 聚合路由，给不同模块添加统一的前缀
app.use('/api/user', userRouter);
app.use('/api/order', orderRouter);
app.listen(3000, () => {
console.log('服务启动在3000端口');
});
内部逻辑复用的实现方式
多个路由共用的逻辑比如登录校验、参数校验、权限判断等，可以抽离为通用中间件，在聚合路由时统一挂载，实现逻辑复用。
通用中间件抽离
比如我们需要给所有用户相关的路由添加登录校验逻辑，不需要在每个路由里单独写，只需要写一个通用中间件：
// middlewares/auth.js 登录校验中间件
module.exports = (req, res, next) => {
// 模拟登录校验逻辑，实际项目中可以校验token等
const token = req.headers.token;
if (!token) {
return res.json({ code: 401, msg: '未登录' });
}
// 校验通过走下一个流程
next();
};
然后在聚合用户路由的时候挂载这个中间件，所有用户路由都会自动经过登录校验：
// app.js 修改路由聚合部分
const authMiddleware = require('./middlewares/auth');
// 给所有用户路由添加登录校验中间件
app.use('/api/user', authMiddleware, userRouter);
高效数据整合的实现
当某个接口需要返回多个数据源的数据时，比如用户详情接口需要同时返回用户基本信息和用户的订单列表，我们可以在路由处理函数中统一整合数据，而不是让前端多次请求。
下面是一个整合用户信息和订单信息的示例：
// routes/user.js 修改用户详情路由
const axios = require('axios');
router.get('/detail/:id', async (req, res) => {
try {
const userId = req.params.id;
// 并行请求用户基本信息和订单信息，提升效率
const [userRes, orderRes] = await Promise.all([
// 模拟请求用户服务获取用户信息
Promise.resolve({ data: { id: userId, name: '张三', age: 20 } }),
// 模拟请求订单服务获取用户订单
Promise.resolve({ data: [{ orderId: 1001, amount: 200 }] })
]);
// 整合两个数据源的数据
const result = {
code: 0,
data: {
userInfo: userRes.data,
orderList: orderRes.data
}
};
res.json(result);
} catch (err) {
res.json({ code: 500, msg: '数据获取失败' });
}
});
路由聚合的优化建议
- 按照业务域拆分路由文件，避免单个路由文件过大，提升可维护性
- 通用逻辑尽量抽离为中间件，不要在多个路由中重复编写相同代码
- 数据整合时尽量使用并行请求，减少接口响应时间
- 可以给路由添加统一的错误处理中间件，统一处理路由中的异常
通过路由聚合的方式，我们可以让Express项目的路由结构更清晰，减少重复代码，同时高效完成多数据的整合工作，让项目的可维护性和性能都得到提升。