Express Router动态路由先于命名路由匹配问题咨询

结论 #

这不属于代码语法错误，是路由定义顺序不符合Express匹配规则导致的逻辑错误。

路由匹配异常原理 #

Express的路由匹配遵循从上到下、优先匹配的规则：

• 当收到客户端请求时，Express会按你编写路由的先后顺序逐个比对请求路径
• 一旦找到第一个匹配成功的路由，就会直接执行对应的处理函数，后续的同请求方法路由不会再被匹配校验

你提到的:id属于动态参数路由，它可以匹配该路径层级下的任意字符串值。当你把clients.get('/:id', ...)放在clients.get('/getAllProspects', ...)之前时，请求/clients/getAllProspects路径时，Express会把路径中的getAllProspects识别为:id的参数值，直接命中第一个动态路由，不会再向下匹配到固定路径的getAllProspects路由。

修复方案 #

• 方案1：固定路径路由永远放在动态参数路由之前，保持你最初的编写顺序即可：

// 先定义固定路径路由
clients.get('/', ClientsController.getAll)
clients.get('/getAllProspects', ClientsController.getAllProspects)
// 最后定义动态参数路由
clients.get('/:id', ClientsController.getClientData)

• 方案2：如果你的id参数有固定格式规则（比如纯数字），可以给动态路由加正则约束，这样只有符合规则的参数才会命中该路由，和固定路径路由的顺序就不会冲突：

// 仅当id为数字时命中该路由
clients.get('/:id(\\d+)', ClientsController.getClientData)
clients.get('/getAllProspects', ClientsController.getAllProspects)

内容的提问来源于stack exchange，提问作者Lucas Leite