Go 的 http.FileServer 为什么直接托管 SPA 会 404？
因为 http.FileServer 只按路径找真实文件，而 SPA 的路由（比如 /dashboard、/user/profile）根本没对应磁盘文件，一访问就返回 404。它不理解前端路由是靠 JS 在浏览器里“假装跳转”的。
常见错误现象：GET /admin → 404，但 GET /index.html 能打开；刷新任意前端路由页面就崩。
- 必须拦截所有非静态资源请求（即不是
.js、.css、.png等后缀），统一 fallback 到index.html - 别用
http.StripPrefix后直接套http.FileServer—— 它不处理 fallback，只是路径前缀处理 - 优先匹配已知静态后缀，再兜底；否则图片、API 请求也可能被误导向
index.html
用 http.ServeFile + 自定义 http.Handler 实现正确 fallback
不用第三方库也能搞定，核心是自己写个 handler：先检查请求路径是否对应真实静态文件，有就 serve；没有就返回 index.html 内容（注意状态码仍是 200）。
使用场景：纯 Go 标准库部署、CI/CD 流程中避免引入额外依赖、需要精确控制 MIME 类型或缓存头。
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 用
os.Stat检查./dist/<path>是否存在且是文件，比正则后缀判断更可靠 -
http.ServeFile(w, r, "./dist/index.html")必须在 fallback 分支里调用，不能只写路径字符串 - 别忘了对
index.html手动设置Content-Type: text/html; charset=utf-8，否则某些浏览器可能乱码
func spaHandler(root http.FileSystem) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
path := strings.TrimPrefix(r.URL.Path, "/")
if path == "" {
http.ServeFile(w, r, "./dist/index.html")
return
}
f, err := root.Open(path)
if err != nil {
http.ServeFile(w, r, "./dist/index.html")
return
}
defer f.Close()
http.ServeContent(w, r, path, time.Now(), f)
})
}
静态资源压缩与缓存头怎么配才不翻车？
Go 默认不压缩响应体，也不设缓存策略 —— 直接上线会导致首屏慢、重复下载大文件。但乱加 Cache-Control 又会让用户看不到新版本。
性能影响：未压缩的 main.js（2MB）在 3G 网络下可能多耗 3 秒；没 ETag 的静态资源每次都会发 GET 请求（哪怕没改）。
- 对
.js、.css、.html响应手动加w.Header().Set("Cache-Control", "public, max-age=31536000")，前提是文件名带哈希（如main.a1b2c3.js） - HTML 必须用
no-cache或短时间max-age，否则用户永远刷不到新路由逻辑 - 压缩建议用
golang.org/x/net/http2/h2c配合反向代理（如 Nginx）做，标准库net/http不内置 gzip 中间件
开发时用 go:embed 替代文件系统读取更安全
打包进二进制后，./dist 目录不存在了，os.Stat 会失败。用 embed 能把前端产物编译进程序，启动时不依赖外部路径。
容易踩的坑：//go:embed dist/* 不会递归嵌入子目录，dist/js/app.js 这种路径不会被包含。
- 必须写成
//go:embed dist/**（双星号）才能覆盖所有嵌套文件 -
embed.FS返回的文件路径是相对dist/的，所以r.URL.Path要去掉开头的/，再拼到fs.ReadFile("dist/" + path) - 调试时如果看到
open dist/index.html: file does not exist，八成是 embed 模式没生效，检查 go version ≥ 1.16 且 build 命令没加-tags干扰
.html 后缀、favicon.ico 被当成路由兜底、或者构建产物里混进了隐藏文件导致 embed 失败。这些细节不跑一遍真实请求很难发现。 
