http.FileServer常404主因是相对路径依赖工作目录，须用filepath.Abs或os.DirFS转绝对路径，并配合http.StripPrefix（末尾带/）对齐URL与磁盘路径，SPA需自定义fallback，缓存与MIME需手动设置。
直接用 http.FileServer 搭静态服务没问题，但 90% 的 404、路径遍历、缓存失效、SPA 刷新 404 都是因为没对齐「请求路径」和「磁盘路径」这两层映射关系。
为什么 http.FileServer(http.Dir("static")) 常常 404
根本不是函数写错了，而是 http.Dir 接收的是磁盘路径，而你传的 "static" 是相对路径 —— 它依赖当前工作目录（os.Getwd()），但 go run、go build && ./app、Docker 启动时的工作目录很可能完全不同。
- 开发时在项目根目录跑
go run main.go，"static"指向正确；上线后二进制放在/usr/local/bin，工作目录变成那里，"static"就找不到了 - 永远用
filepath.Abs("static")或os.DirFS(filepath.Join(dir, "static"))替代裸字符串 -
os.DirFS（Go 1.16+）比http.Dir更安全：自动拒绝../路径穿越，且不依赖os.Stat权限检查逻辑 - 启动前加一行日志：
log.Printf("serving static from: %s", absPath)，避免猜路径
http.StripPrefix 不是“美化 URL”，它决定文件怎么找
比如你希望浏览器访问 /assets/main.css 时读取磁盘上 ./static/css/main.css，那必须满足两个条件：
-
http.Handle("/assets/", ...)—— 注册路由前缀 -
http.StripPrefix("/assets/", fs)—— 把请求路径/assets/main.css变成/main.css，再交给fs去./static下找 - 前缀末尾必须带
/："/assets/"✅，"/assets"❌（否则/assets123也会被 strip） - 顺序不能反：一定是
StripPrefix → FileServer，反过来就绕过路径过滤
SPA fallback 不能靠 http.FileServer 自动兜底
http.FileServer 对不存在的路径直接返回 404，它不会尝试找 index.html。Vue/React 刷新 /user/123 报 404，就是这个原因。
- 别用
http.ServeFile(w, r, "index.html")硬写根路由 —— 它不处理子路径，也不校验文件是否存在 - 正确做法：用
http.HandlerFunc先查文件是否存在，存在则透传给FileServer，否则返回index.html - 或者更简单：只对根路径
/和无后缀路径（如/about）做 fallback，其余仍走FileServer - 注意 MIME 类型：
c.File("index.html")在 Gin 里安全，但原生 net/http 要手动设w.Header().Set("Content-Type", "text/html; charset=utf-8")
缓存头、目录列表、MIME 类型这些都得自己补
http.FileServer 默认什么头都不设，也不猜扩展名 —— .webp 可能返回 text/plain，.js 没 Cache-Control 导致反复下载。
- 加缓存最简方式：包一层 handler，对
.js、.css、.png等设Cache-Control: public, max-age=31536000；HTML 设no-cache - 禁用目录列表：确保目标目录下没有
index.html，且别用任何自定义的 “listable Dir” 实现（标准库不提供） - MIME 类型靠
http.DetectContentType不靠谱，优先用mime.TypeByExtension(path.Ext(name)) - 别碰
http.ServeContent—— 它要你手动传modtime和size，容易错，还绕过FileServer的 gzip 和 range 支持
真正麻烦的从来不是“怎么写几行代码启动服务”，而是路径是否绝对、前缀是否带斜杠、fallback 是否覆盖所有前端路由、缓存策略是否按资源类型区分 —— 这些细节一漏，线上就静默失败。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
