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

背景介绍

Express 5.x 版本对路由匹配语法进行了重要变更，特别是针对通配符(*)的使用方式。这一变更影响了开发者常用的app.all()和类似路由匹配模式，导致部分从 Express 4.x 升级的应用出现路由匹配问题。

核心变更点

Express 5.x 中，路由匹配引擎做了以下关键调整：

1. 命名参数要求：所有通配符(*)必须被赋予名称，行为与常规参数(:param)一致
2. 语法格式变更：从/*变为/*splat或/{*paramName}
3. 空路径匹配：/*splat不再匹配空路径(如/)，需要使用/{*splat}才能保持与4.x相同行为

实际案例分析

案例1：API路由前缀匹配

在Express 4.x中常见的跨域头设置代码：

app.all('/api/*', function(req, res, next) {
  // 设置各种CORS头
  next();
});

升级到5.x后，正确的写法应为：

app.all('/api/*splat', function(req, res, next) {
  // 设置各种CORS头
  next();
});

或者更推荐使用app.use的路径前缀匹配：

app.use('/api', function(req, res, next) {
  // 设置各种CORS头
  next();
});

案例2：根路径匹配

Express 4.x中匹配所有路径的写法：

app.get('/*', (req, res) => res.send("ok"));

在5.x中需要修改为：

app.get('/{*splat}', (req, res) => res.send("ok"));

这样才能确保根路径/也能被正确匹配。

技术原理

Express 5.x底层使用了path-to-regexp库的新版本，该库对通配符行为做了更严格的规范：

1. 通配符参数必须匹配一个或多个字符
2. 要匹配零个或多个字符(包括空路径)，必须使用可选组语法{}
3. 所有参数必须命名，提高了路由定义的可读性和可维护性

最佳实践建议

1. 优先使用app.use：对于前缀匹配场景，app.use是更清晰的选择
2. 明确参数命名：给通配符参数赋予有意义的名称，如/*apiPath而非简单的/*splat
3. 全面测试：升级后需特别测试边界情况，如根路径、单斜杠路径等
4. 文档参考：仔细阅读Express 5.x迁移指南中的路由语法部分

总结

Express 5.x对路由语法的变更虽然带来了短暂的适配成本，但使路由匹配行为更加明确和一致。理解这些变更背后的设计理念，能够帮助开发者编写出更健壮、可维护的路由逻辑。在升级过程中，重点关注通配符匹配场景，并适当调整测试策略，可以确保平稳过渡到新版本。