Gin默认不设Cache-Control头导致静态文件无缓存，需手动为/static/路径注入public, max-age=31536000等策略，且StaticFile注册的favicon.ico等需单独处理Header，ETag须验证生效。
为什么静态文件没缓存，浏览器反复拉取？
因为 Gin 的 Static 和 StaticFS 默认不设 Cache-Control 头，浏览器每次都会发新请求，既拖慢页面加载，又增加服务器压力。这不是 bug，是设计使然——框架默认保守，由你按需控制。
关键不是“加缓存”，而是加对的缓存策略：JS/CSS 用强缓存（max-age=31536000），HTML 用协商缓存（no-cache 或直接禁用），否则前端路由更新后用户仍看到旧版 index.html。
- 别全局加
Cache-Control: public, max-age=3600—— HTML 和 JS 混用同一策略会导致页面无法热更新 - 别依赖中间件统一拦截所有请求加头 ——
/api/路由也会被污染 - Windows 下路径含空格或中文时，
c.Header()可能失效，优先用strings.HasPrefix(c.Request.URL.Path, "/static/")判断
如何给 /static/ 下的文件加强缓存？
最稳妥的方式是包装 Static handler，在匹配到静态路径时手动注入响应头。Gin 不提供原生缓存配置参数，必须自己动手。
示例代码（放在 r.Static("/static", "./dist/static") 之后）：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
r.Use(func(c *gin.Context) {
if strings.HasPrefix(c.Request.URL.Path, "/static/") {
c.Header("Cache-Control", "public, max-age=31536000")
c.Header("ETag", "") // Gin v1.9.1+ 自动计算，留空即可触发
}
c.Next()
})
-
max-age=31536000对应 1 年，适用于带哈希名的构建产物（如app.a1b2c3.js） - 若用的是未哈希文件（
app.js），把max-age改成3600，并配合版本号 URL（如/static/app.js?v=1.2.0） - 别忘了在构建阶段替换 CDN 域名（如把
/static/替换为https://cdn.example.com/），否则缓存策略再好也走不了 CDN
为什么 favicon.ico 或 /robots.txt 缓存失效？
因为它们通常用 StaticFile 单独注册，比如 r.StaticFile("/favicon.ico", "./static/favicon.ico") —— 这类路由绕过中间件，c.Header() 不生效。
解决办法只有两个：
- 改用
StaticFS统一托管：把favicon.ico放进./static/目录，然后用r.StaticFS("/static", http.Dir("./static"))，再配中间件加头 - 对单个
StaticFile手动写头：在 handler 里调用c.Header()，再c.File()
例如：
r.StaticFile("/favicon.ico", "./static/favicon.ico")
// → 改为：
r.GET("/favicon.ico", func(c *gin.Context) {
c.Header("Cache-Control", "public, max-age=86400")
c.File("./static/favicon.ico")
})
生产环境必须检查的三个细节
缓存策略上线前，务必验证这三点，否则可能造成大面积白屏或资源加载失败：
-
ETag是否生效：用curl -I http://localhost:8080/static/js/app.js看响应头是否有ETag字段；Gin - 文件权限是否可读：Linux 下若
./dist/static/目录属主不是运行 Go 进程的用户，os.Stat会失败，导致 500 错误而非 404 - MIME 类型是否正确：浏览器拒绝执行
text/plain的 JS 文件，确保.js返回application/javascript—— Gin 默认已做映射，但若自定义了http.FileSystem，需额外处理
真正容易被忽略的，是缓存头和构建产物哈希机制的耦合关系：没哈希就别设一年缓存，否则用户永远拿不到新版 JS。
