Node.js Express中/newblogs端点调用异常的原因解析

问题场景 #

在开发Node.js Express项目时出现路由混淆问题：将/newblogs端点配置在动态路由/:id之后时，调用/newblogs会触发/:id对应的处理函数并报错；将/newblogs移至/:id之前后问题解决，需了解该现象的原因。

初始代码（存在问题） #

import express from 'express'
import * as blogControler from '../controler/blogControler.js'
import * as authControler from '../controler/authControler.js'

const blogRouter= express.Router()

blogRouter.use(authControler.isVerified)

blogRouter.route('/allblogs').get(blogControler.showallblogs)
blogRouter.route('/:id').get(blogControler.find_blog)
blogRouter.route('/newblogs').get(blogControler.newpost)

export default blogRouter;

修改后代码（问题解决） #

import express from 'express'
import * as blogControler from '../controler/blogControler.js'
import * as authControler from '../controler/authControler.js'

const blogRouter= express.Router()

blogRouter.use(authControler.isVerified)

blogRouter.route('/allblogs').get(blogControler.showallblogs)
blogRouter.route('/newblogs').get(blogControler.newpost)
blogRouter.route('/:id').get(blogControler.find_blog)

export default blogRouter;

原因解析 #

• Express的路由匹配遵循从上到下的顺序优先级，一旦找到第一个匹配的路由规则，就会停止后续匹配并执行对应处理函数。
• 动态路由/:id属于通配规则，它会匹配任意单一路径段（比如/123、/test，也包括/newblogs），将路径内容作为id参数传递给处理函数。
• 初始代码中/:id定义在/newblogs之前，请求/newblogs时会先匹配到/:id，把newblogs当作id参数传入find_blog函数，但该函数逻辑是处理博客ID查询的，因此会因参数不符合预期报错。
• 修改后/newblogs的静态路由定义在/:id之前，请求/newblogs时会先匹配到精确的静态路由规则，执行newpost处理函数，不会触发后续的动态路由匹配。

内容的提问来源于stack exchange，提问作者mohamed zaheen