gin.staticfs 404 因未正确配置路由前缀和文件目录：必须用 router.staticfs("/static", http.dir("./dist"))，且 /static 需与 url 前缀一致；子目录资源需以 dist 为根；spa 首页需 noroute + c.file 兜底；生产环境须用 gin v1.9.1+ 保证 etag 缓存；docker 中应使用 os.executable 定位绝对路径。
为什么 http.FileServer 直接传给 gin.StaticFS 会 404？
因为 gin.StaticFS 不是简单包装 http.FileServer，它内部做了路径前缀截断和 URL 路由匹配逻辑。如果你把 http.Dir("./static") 直接塞进去，但没配对的路由前缀（比如 GET /static/*filepath），Gin 根本不会把请求转发给文件服务。
- 必须用
router.StaticFS("/static", http.Dir("./static"))，其中/static是公开 URL 前缀，也是 Gin 匹配路由的依据 - 如果静态资源放在子目录（如
./dist/assets），http.Dir要指向最外层可访问根目录，不能写成http.Dir("./dist/assets")—— 否则/static/logo.png会被映射到./dist/assets/static/logo.png，显然不存在 -
http.FileServer默认不处理目录索引，访问/static/会 404；加http.StripPrefix也不解决这个问题，Gin 的StaticFS本身就不支持自动index.html回退
如何让 / 自动返回 index.html 而不是 404？
Gin 没有内置 SPA fallback，但可以用 router.NoRoute + 手动读取文件兜底，比全量代理更轻、更可控。
- 先注册正常静态路由：
router.StaticFS("/static", http.Dir("./dist")) - 再在
NoRoute里尝试读取./dist/index.html：router.NoRoute(func(c *gin.Context) { if c.Request.URL.Path == "/" { c.File("./dist/index.html") return } c.Status(404) }) - 别用
c.Redirect或c.Request.URL.Path = "/index.html"—— Gin 的路由已结束，改 Path 不生效；也别用http.ServeFile，它不走 Gin 中间件（如 CORS） - 注意文件权限：如果
./dist/index.html不存在或不可读，c.File会 panic，建议加os.Stat判断
http.FileServer 和 gin.StaticFS 在生产环境的性能差异在哪？
核心区别不在吞吐，而在响应头控制和内存行为：http.FileServer 默认带 Content-Length 和 ETag，而 gin.StaticFS 在 v1.9+ 才补上 ETag，旧版本默认不设缓存头，浏览器反复拉取。
- 确保用 Gin v1.9.1+，否则
StaticFS返回的静态文件没有ETag，无法利用 304 缓存 -
http.FileServer对大文件是流式读取，gin.StaticFS也是，但若你手动用c.DataFromReader拼装响应，容易误用io.ReadAll把整个文件读进内存 - 不要在中间件里对静态路径做
c.Next()—— 静态文件响应不走后续中间件，加了也没用，还可能干扰日志或 auth 逻辑
部署时路径错乱：本地 OK，Docker 里 404 怎么查？
根本原因几乎全是工作目录（pwd）和 Go 二进制运行路径不一致，导致 http.Dir("./dist") 指向错误位置。
立即学习“go语言免费学习笔记（深入）”；
- 用绝对路径替代相对路径：
http.Dir(filepath.Join(os.Getenv("PWD"), "dist"))不可靠，因为容器里PWD可能未设置；更稳妥的是用os.Executable定位二进制所在目录：exePath, _ := os.Executable() distDir := filepath.Join(filepath.Dir(exePath), "dist") router.StaticFS("/static", http.Dir(distDir)) - Dockerfile 里 COPY 静态资源时，确认目标路径和代码里
http.Dir一致，比如COPY dist /app/dist，那代码里就得用http.Dir("/app/dist") - 上线前加一行健康检查：
curl -I http://localhost:8080/static/favicon.ico，看是否返回 200 + 正确Content-Type
最容易被忽略的是：Gin 的 StaticFS 对路径大小写敏感，Windows 开发时 /Static/ 和 /static/ 可能都通，Linux 容器里只认严格匹配的那个。
