http.fileserver启动即404的根本原因是路径映射未对齐：它不自动补斜杠、不查找index.html、不解析相对路径；http.dir("static")依赖工作目录，os.dirfs+filepath.abs可解决，且必须配合http.stripprefix("/static/", ...)并确保前缀带尾部斜杠。
直接用 http.FileServer 能跑起来，但不加处理大概率 404、目录遍历、缓存失效或刷新白屏——它只是个裸 handler，不是开箱即用的“服务器”。
为什么 http.FileServer 启动就 404？
根本原因不是代码写错，而是路径映射没对齐。它不做自动补斜杠、不查 index.html、也不解析相对路径。
-
http.Dir("static")是相对路径：工作目录一变（比如从项目根进到cmd/下运行），static/就找不到，首次请求直接 404 - 访问
/assets（无尾部/）而assets是目录？返回 404，不会重定向到/assets/ - 访问
/或/docs/？除非显式请求/index.html，否则 404 —— 它根本不尝试 fallback - 挂载前缀如
/static/却漏掉http.StripPrefix？请求/static/main.css会被当成去读./static/static/main.css，必然 404
如何安全地用 os.DirFS 替代 http.Dir？
os.DirFS（Go 1.16+）是更现代、更安全的选择，它默认拒绝 ../ 和 URL 编码绕过（如 %2e%2e%2fetc%2fpasswd），不用额外写校验逻辑。
- 必须传绝对路径：
os.DirFS(filepath.Abs("./public"))，别信"./public"能跨环境工作 -
http.StripPrefix的前缀必须以/结尾："/static/"✅，"/static"❌（否则/static123也会被 strip） - 顺序不能反：先
StripPrefix，再交给FileServer；反过来调用ServeHTTP会绕过内置路径校验 - Linux 下注意权限：SELinux 或用户组限制可能静默导致 403，错误日志里不报具体路径，只返回 404 或 500
SPA 应用刷新 404 怎么 fallback 到 index.html？
http.FileServer 不做 fallback，这是常见误解。React/Vue 的 History 模式下，/user/123 这种前端路由必须由后端返回 index.html，否则就是白屏。
- 不能依赖任何“自动 fallback”机制，得自己判断文件是否存在
- 先用
os.Stat检查请求路径对应的真实文件是否存在 - 不存在且路径无扩展名（如
/admin、/about/），才用http.ServeFile(w, r, "index.html") - 注意 MIME：直接
os.ReadFile返回 HTML 会丢掉正确类型，必须用http.ServeFile或手动设w.Header().Set("Content-Type", "text/html; charset=utf-8")
生产环境必须加的三层包装是什么？
原生 http.FileServer 是裸的，性能和安全靠你补全。缺一层，上线就出问题。
-
缓存头：默认无
Cache-Control，JS/CSS 每次重刷都重拉。对带哈希的构建产物设public, max-age=31536000；HTML 设no-cache -
gzip 压缩：用
gzip.Handler包整个 handler，但注意别和 Nginx 双重压缩（Nginx 已压时关掉 Go 层） -
路径防护：用
os.DirFS或自定义http.FileSystem，确保不接受越界路径；禁用目录列表（别让/static/返回文件列表）
最易被忽略的是：上线前不检查工作目录和权限，只在本地验证路径是否通——部署后因路径错位或 SELinux 限制，服务看似启动成功，实际所有静态请求都 403/404，还查不到明确错误来源。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
