Express合法请求下部分API端点返回404的原因排查

按出现概率从高到低排列可能原因：

• 路由定义和预期路径不匹配：你在评论路由旁的注释明确标注预期路径为/posts/comment/123456789，但实际定义的路由是/comment/submit/:id/，挂载/api前缀后实际匹配路径为/api/comment/submit/帖子ID，和你注释里的预期路径差了一层/posts前缀。如果你实际测试时按照注释的路径请求/api/posts/comment/submit/帖子ID，会完全匹配不到你定义的评论路由，直接返回404——这是最高概率的根因，毕竟你自己写的注释已经暴露了路径认知偏差。
• 鉴权中间件做了路径拦截：评论接口绑定的前置中间件Utility.verifyAndPassData同时给/posts/vote接口使用，而后者运行正常，说明中间件基础逻辑没问题，但要排查中间件内部是否写了路径白名单规则，比如仅放行/posts前缀的请求，对/comment前缀的请求直接返回404，这种情况下请求根本不会走到控制器逻辑，你替换控制器代码打log也不会有输出。
• 严格路由模式下的末尾斜杠不匹配：如果你项目开启了strict routing配置，路由末尾的斜杠会被严格校验。你定义的评论路由末尾带斜杠/comment/submit/:id/，如果请求时URL末尾没加斜杠，会被判定为路径不匹配返回404。可以对比其他接口的请求习惯验证，比如你请求/api/posts（不带末尾斜杠）能正常访问/posts/定义的路由，说明大概率没开这个配置，仅作次优先级排查。
• 路由注册顺序冲突：如果你实际代码里在评论路由前定义了匹配范围更大的动态路由（比如/comment/*这类通配路由），且该路由没有处理PUT方法，会提前拦截请求导致匹配不到评论接口。从你贴的代码来看不存在这个问题，仅在你贴的代码和实际运行代码不一致时需要排查。

优先核对请求URL和路由定义的路径是否完全一致，90%的同类Express路由404问题都是路径拼写差了一段前缀导致的。

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