Express路由深度解析：从基础到高级实践

在这里插入图片描述

一、路由基础：构建Web应用的骨架

1.1 路由三要素

app.METHOD(PATH, HANDLER)

METHOD‌：HTTP动词（get/post/put/delete等）
‌PATH‌：URL路径（支持动态参数）
‌HANDLER‌：路由处理函数（中间件）

1.2 基础路由示例

// 基本GET路由
app.get('/api/books', (req, res) => {
  res.json([{title: 'Node.js实战'}]); 
});

// 带参数的路由
app.get('/books/:id', (req, res) => {
  const book = findBookById(req.params.id);
  res.json(book);
});

二、路由模块化：企业级项目结构

2.1 路由拆分方案

routes/
	├── auth.routes.js    # 认证相关
	├── user.routes.js    # 用户管理
	└── product.routes.js # 商品管理

2.2 模块化路由示例

// routes/user.routes.js
const router = express.Router();

router.get('/', userController.listUsers);
router.post('/', userValidation, userController.createUser);

export default router;

// app.js 主文件
import userRoutes from './routes/user.routes';
app.use('/api/users', userRoutes);

三、高级路由技巧

3.1 路由参数高级用法

// 参数验证中间件
router.param('userId', (req, res, next, id) => {
  if(!isValidObjectId(id)) {
    return res.status(400).json({error: 'ID格式无效'});
  }
  next();
});

// 正则表达式路由
app.get('/user/:id(\\d+)', (req, res) => {
  // 只匹配数字ID
});

3.2 路由链式调用

router.route('/articles')
  .get(articleController.list)
  .post(authMiddleware, articleController.create)
  .all((req, res) => {
    res.status(405).send('方法不允许');
  });

四、路由中间件系统

4.1 中间件执行顺序

4.2 自定义路由中间件

// 日志记录中间件
const routeLogger = (req, res, next) => {
  console.log(`[${new Date().toISOString()}] ${req.method} ${req.path}`);
  next();
};

// 应用中间件
app.use(routeLogger);

// 路由特定中间件
router.get('/admin', adminAuth, adminController.dashboard);

五、性能优化策略

5.1 路由懒加载

// 动态路由加载（适用于大型应用）
app.get('/plugins/:pluginName', async (req, res) => {
  const handler = await import(`./plugins/${req.params.pluginName}`);
  handler.default(req, res);
});

5.2 路由缓存方案

const routeCache = require('route-cache');

// 缓存高频路由
app.get('/popular-products', 
  routeCache.cacheSeconds(60),
  productController.listPopular
);

六、实战项目演示

6.1 RESTful API设计

router.get('/products', productController.list);
router.post('/products', auth, productController.create);
router.get('/products/:id', productController.detail);
router.put('/products/:id', auth, productController.update);
router.delete('/products/:id', adminAuth, productController.delete);

6.2 错误处理中间件

// 404处理
app.use((req, res, next) => {
  res.status(404).json({ error: '找不到路由' });
});

// 统一错误处理
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).send('服务器内部错误');
});