静态页和后端路由打架:一个真实项目里的踩坑记录
- 作者:管理员
- 发表时间:2026-09-13 17:30:00
- 来源:本站
这次踩的坑挺典型,值得记一笔。
项目背景是:一个原本由纯静态HTML构成的企业站,需要改造成带后台的动态站点。技术上用的是常见的服务端渲染方案,路由按顺序注册。
01 现象:新路由完全不生效
改造完成后,首页正常,但新加的几个动态栏目页全部打不开,返回的是旧版本的静态页面。
奇怪的是,日志里根本没有这些请求的记录。也就是说,请求压根没到应用层。
02 第一轮排查:以为是路由顺序
第一反应是路由注册顺序问题——通配路由写在了前面,把所有请求都吃掉了。
调整顺序后,问题依然存在。而且日志仍然没有记录,说明请求根本没进来。
03 第二轮排查:发现是静态文件拦截
打开项目根目录一看,找到了原因。
根目录下存在着旧版遗留的静态HTML文件,名字和新栏目路由完全一样。服务端在注册路由之前,先挂载了静态资源中间件。
结果就是:请求进来,静态中间件先匹配到了同名的物理文件,直接返回了旧页面,后面的路由逻辑根本没机会执行。
04 解决方式
思路其实很清楚:要么让静态中间件放过这些路径,要么把旧文件挪走。
最终做法是:把旧版静态页面统一归档到备份目录,同时把新站真正需要的静态资源集中到一个独立的资源目录下,静态中间件只挂载这个目录。
这样动态路由和静态资源就各管各的,不再互相干扰。
05 这件事的三点教训
第一,改造老站时,一定要先清点根目录下的历史遗留文件。它们不会报错,但会在你意想不到的地方生效。
第二,调试路由问题时,先确认请求有没有到达应用层。如果日志里没有记录,就别再改路由了,方向错了。
第三,静态资源中间件的挂载路径要尽量收窄,不要图省事直接挂在根目录。
06 结语
这类问题的特点是:代码本身一行没错,错在项目结构。排查时需要跳出代码,去看整个请求链路。
记录下来,给以后遇到类似情况的人省半天时间。