静态页和后端路由打架:一个真实项目里的踩坑记录
  • 作者:管理员
  • 发表时间:2026-09-13 17:30:00
  • 来源:本站

这次踩的坑挺典型,值得记一笔。

项目背景是:一个原本由纯静态HTML构成的企业站,需要改造成带后台的动态站点。技术上用的是常见的服务端渲染方案,路由按顺序注册。

01 现象:新路由完全不生效

改造完成后,首页正常,但新加的几个动态栏目页全部打不开,返回的是旧版本的静态页面。

奇怪的是,日志里根本没有这些请求的记录。也就是说,请求压根没到应用层。

02 第一轮排查:以为是路由顺序

第一反应是路由注册顺序问题——通配路由写在了前面,把所有请求都吃掉了。

调整顺序后,问题依然存在。而且日志仍然没有记录,说明请求根本没进来。

03 第二轮排查:发现是静态文件拦截

打开项目根目录一看,找到了原因。

根目录下存在着旧版遗留的静态HTML文件,名字和新栏目路由完全一样。服务端在注册路由之前,先挂载了静态资源中间件。

结果就是:请求进来,静态中间件先匹配到了同名的物理文件,直接返回了旧页面,后面的路由逻辑根本没机会执行。

04 解决方式

思路其实很清楚:要么让静态中间件放过这些路径,要么把旧文件挪走。

最终做法是:把旧版静态页面统一归档到备份目录,同时把新站真正需要的静态资源集中到一个独立的资源目录下,静态中间件只挂载这个目录。

这样动态路由和静态资源就各管各的,不再互相干扰。

05 这件事的三点教训

第一,改造老站时,一定要先清点根目录下的历史遗留文件。它们不会报错,但会在你意想不到的地方生效。

第二,调试路由问题时,先确认请求有没有到达应用层。如果日志里没有记录,就别再改路由了,方向错了。

第三,静态资源中间件的挂载路径要尽量收窄,不要图省事直接挂在根目录。

06 结语

这类问题的特点是:代码本身一行没错,错在项目结构。排查时需要跳出代码,去看整个请求链路。

记录下来,给以后遇到类似情况的人省半天时间。