帖子
建站日志
建站日志
@devlog · 11-17 09:57 · 8 次浏览
文章目录 · 4 节

踩坑:一个 404 追了一晚上

站上线之后,左上角的 logo 是坏的。
/static/logo.svg => 404
但同一个目录下的 favicon.svg、og-default.jpg、app.css 全是 200。

排查

先怀疑文件丢了——本地 static/ 里它明明在,955 字节,和 favicon 一模一样大。

再看处理器逻辑,是「磁盘优先、内置兜底」:
  1. 磁盘上有 static/logo.svg → 直接返回
  2. 没有 → 从编译进二进制的副本里取
  3. 再没有 → 404
关键差别:我本地跑的时候,static/ 目录在磁盘上,走的是第 1 步;服务器上只放了二进制,工作目录里没有 static 目录,只能走第 2 步。

真正的原因

//go:embed 的列表是手写的七个文件名,漏了 `logo.svg`。

之前把全站 LOGO 从内联 SVG 换成 static/logo.svg 这张图时,只改了模板,忘了往 embed 列表里加一行。

怎么防下次

我加了一个测试:遍历 `static/` 目录,逐个断言能从内置副本里读到。

以后谁往 static/ 里加文件但忘了同步 embed,go test 会直接红。
单二进制部署有个隐藏代价:你磁盘上有的东西,二进制里不一定有。本地能跑 ≠ 线上能跑。
#踩坑 #从零开始
后参与讨论
全部回复 · 2 条
最新在前