如何解决Express 5.1.0中的path-to-regexp依赖问题？

API 探路者

2026-4-13

哎，我之前刚踩过Express 5.1.0这个path-to-regexp依赖的坑，刚好你贴的这段TypeScript代码和我当时写的差不多，给你分享几个亲测有效的解决办法：

首先得搞清楚，Express 5.1.0升级了内部依赖的path-to-regexp版本，很多时候报错要么是版本不兼容，要么是类型包没跟上，咱们一步步来：

先清掉旧依赖重新装：有时候是缓存或者依赖树冲突导致的，直接删了node_modules和package-lock.json，然后重新安装就能解决大部分问题：
```
rm -rf node_modules package-lock.json
npm install
```
匹配TypeScript类型包版本：你是用TS开发的对吧？一定要确保@types/express的版本和Express 5.1.0兼容，别装成旧版本的类型包，执行这个命令装对应版本的类型：
```
npm install @types/express@^5.0.0 --save-dev
```
检查路由写法适配新规则：path-to-regexp升级后，一些旧的路由参数写法可能不生效了，比如之前有些复杂的正则路由现在要调整语法。不过你代码里的app.get('/')和app.all('*')这种基础写法是完全没问题的，不用改。
手动指定依赖版本（终极方案）：如果上面的方法都不管用，直接在package.json里锁定path-to-regexp的版本到Express 5.1.0要求的版本。如果用npm的话，先装npm-force-resolutions工具，然后在package.json里加：
```
"scripts": {
  "preinstall": "npx npm-force-resolutions"
},
"resolutions": {
  "path-to-regexp": "^0.1.10"
}
```
然后再重新安装依赖就行；如果用yarn的话，直接加resolutions字段不用装工具。