静态资源 404 全是文件名大小写 批量改名怎么不返工

上线后监控报 404 飙到 137 个每分钟。逐个看,全是图片和字体,路径形如 /Images/Logo.PNG、/Css/Main.css。

本地 macOS 跑得好好的。APFS 默认不区分大小写,Linux 的 ext4 区分,同一份代码两边行为不同。这个差异在开发机上永远复现不了,只有上了服务器才露头。上线前在 Linux 容器里跑一遍构建,能挡住大半。

先统计影响面。access.log 里按路径聚合,前 10 个 404 占了 82%,都是同一个模板里写死的大写目录名。

grep ' 404 ' access.log | awk '{print $7}' | sort | uniq -c | sort -rn | head -20

想的是让 nginx 不区分大小写。location 里加 ~* 正则匹配,再用 try_files 兜底,能跑通。问题是 CDN 的缓存键仍然区分大小写,同一个文件缓存两份,回源多一倍,还容易出现一份过期一份没过期。放弃。

改成改引用。写脚本扫模板和 CSS 里的 url() 与 src,取出路径,和磁盘上的真实文件名做小写比对,不一致的列出来人工确认后替换。137 个引用改到 0,花了两个小时。脚本会输出一份 diff 清单,改完再全量扫一遍,确认没有新引入的。

构建期加一道卡口。CI 里遍历产物目录建一份小写文件名 map,再扫 HTML 和 CSS 引用,找不到或者大小写对不上就 fail。位置放在打包之后、上传之前。

CI 用 Linux 容器跑,macOS 和 Windows 的开发机不会再漏。NTFS 同样不区分大小写,靠人眼检查是靠不住的。

回归用抓站工具跑全站链接,404 数量作为发布门槛,大于 0 就拦住。这次是上线两小时后才被监控发现,太被动。

您可以还会对下面的文章感兴趣: