Express 5.x 路由通配符语法变更详解

背景介绍

Express 5.x 版本对路由语法进行了重要调整，特别是针对通配符(*)的使用方式。这一变更影响了开发者常用的通配符路由匹配方式，需要特别注意迁移策略。

核心变更点

Express 5.x 中，路由通配符必须命名，不再支持匿名通配符。具体表现为：

1. 旧语法：app.all('/api/*', handler)
2. 新语法：app.all('/api/*splat', handler)

常见问题场景

1. 基础通配符路由

在 Express 4.x 中，/*可以匹配所有路径，包括根路径/。但在 5.x 中：

• /*splat 无法匹配根路径/
• 需要使用/{*splat}语法才能保持与 4.x 相同的行为

2. 中间件路由

对于设置全局响应头的场景，建议改用app.use方式：

app.use("/api", (req, res, next) => {
    // 设置响应头
    next();
});

这种方式更清晰且不受通配符语法变更影响。

迁移建议

1. 简单替换：将/*替换为/*paramName
2. 保持兼容：如需完全匹配4.x行为，使用/{*paramName}
3. 优先使用app.use：对于中间件场景，优先考虑使用app.use

技术原理

这一变更源于底层依赖库path-to-regexp的更新。新版本中：

• 命名参数成为强制要求
• 通配符默认匹配一个或多个字符
• 使用{}包裹可表示可选匹配

实际应用示例

设置跨域头部的正确方式

app.all('/api/*rest', (req, res, next) => {
    res.setHeader('Access-Control-Allow-Origin', '*');
    // 其他头部设置
    next();
});

全路径匹配的正确方式

app.get('/{*all}', (req, res) => {
    res.send('匹配所有路径');
});

总结

Express 5.x 的路由语法变更虽然带来了短暂的迁移成本，但使路由系统更加规范和一致。开发者应理解这些变更背后的设计理念，合理调整现有代码，确保应用平稳升级。