Express中无路径参数路由为何需放在带路径参数路由之前

这个现象是Express路由匹配规则+路径参数特性共同作用的结果，核心规则是：Express会按照路由的代码定义顺序从上到下逐一匹配请求路径，一旦匹配到第一个符合规则的路由，就会直接执行该路由的处理逻辑，不再向后匹配剩余路由。

错误顺序下的执行逻辑 #

当你把带路径参数的/products/:id写在固定路径/products/new前面时：

• 路径参数:id的匹配规则是：可以匹配/products/之后的任意非空字符串段，对内容没有默认限制
• 当你发起/products/new的页面请求时，会首先命中前面的/products/:id路由，Express会把路径里的new字符串解析为req.params.id的值，根本不会执行后面定义的/products/new路由逻辑
• 后续代码调用Mongoose的Product.findById(id)方法时，Mongoose要求传入的id必须符合MongoDB ObjectId的格式（24位十六进制字符串），传入的new完全不符合格式要求，就会抛出你看到的CastError: cast to object failed for value new报错

调整顺序后正常运行的原因 #

你把固定路径/products/new移到/products/:id前面之后：

• 请求/products/new时，会优先匹配到这个路径完全固定的路由，直接返回新建商品的表单页面，不会走到后面的参数路由
• 只有当/products/后面的路径段不是new时，请求才会落到带:id参数的路由上执行商品查询逻辑，自然不会触发类型转换错误

路由编写最佳实践 #

为了避免这类匹配冲突问题，写Express路由时建议遵循两个原则：

• 固定路径的精确匹配路由永远写在前面，带路径参数、通配符的模糊匹配路由写在后面
• 可以给路径参数增加格式校验限制，从规则层面避免错误匹配，比如给商品id参数加上ObjectId格式的正则约束，就算路由顺序写错，不符合格式的路径也不会命中参数路由：

// 仅当id是24位十六进制字符串时才匹配该路由
app.get("/products/:id([0-9a-fA-F]{24})", async (req, res) => {
    const { id } = req.params;
    const product = await Product.findById(id);
    res.render('products/show', { product });
});

内容的提问来源于stack exchange，提问作者theProf.