别用 http.servefile 做业务响应缓存，它只适合静态文件；应自写中间件缓存动态响应，需在写响应前拦截、支持键精细化控制、服务端落地存储，并注意时间归一化与 header 冻结问题。
HTTP 响应缓存该用 http.ServeFile 还是自己写中间件？
直接说结论：别用 http.ServeFile 做业务响应缓存，它只适合静态文件；真正要缓存的是你 http.HandlerFunc 里生成的动态响应（比如 JSON、HTML 模板渲染结果）。自己写轻量中间件更可控，也避免踩坑。
常见错误是把 net/http 的 Cache-Control 头一设就以为“缓存生效了”——其实只是告诉客户端/代理“你可以缓存”，服务端根本没存东西。真正的服务端缓存得自己落地。
- 用
http.ServeFile只能缓存磁盘上已存在的文件，对json.Marshal出来的响应无效 - 中间件方案要区分「响应体是否可缓存」：比如带用户 ID 的接口不能全量缓存，而
/api/status这类无参 GET 就很适合 - 缓存键（key）必须包含 URL 查询参数、
Accept头、甚至Authorization（若需按用户隔离），漏掉任一都可能返回错内容
用 sync.Map 缓存响应体安全吗？
短周期、低并发、开发环境可以，生产环境不推荐。因为 sync.Map 不支持过期淘汰，缓存会无限增长，且无法按 LRU 清理旧项。
更现实的选择是：小项目用 github.com/patrickmn/go-cache（内存型，带 TTL），中大型项目直接上 Redis，用 GET/SET + EX 控制过期。注意 Redis 缓存值必须序列化，推荐 json.RawMessage 或 []byte，别用结构体指针——反序列化时容易 panic。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
sync.Map的LoadOrStore返回interface{}，类型断言失败会导致静默空响应，务必检查 ok - 如果响应体含时间敏感字段（如
"updated_at": "2024-05-20T..."），缓存前得先做时间戳归一化，否则每次响应看起来都“新鲜”但实际没变 - 用 Redis 时，
SET key value EX 60比SETEX更推荐，兼容性更好，且能原子性设置过期
http.ResponseWriter 被写入后还能塞缓存头吗？
不能。一旦调用过 w.WriteHeader() 或往 w 写了响应体，header 就被冻结了。这时候再调用 w.Header().Set("Cache-Control", "...") 是无效的。
所以缓存逻辑必须在写响应前判断：先查缓存 → 命中则直接写 header + body → 未命中则执行 handler，同时捕获输出并存入缓存。典型做法是包装 http.ResponseWriter 实现 ResponseWriter 接口，重写 WriteHeader 和 Write 方法来拦截。
- 别在 handler 里手动调用
w.WriteHeader(200)，让包装器统一控制，否则缓存中间件拿不到状态码 - 如果 handler 中用了
http.Error(w, ...)，它内部会调用WriteHeader，同样会提前锁死 header —— 需确保错误路径也走缓存包装 - 缓存响应体时，记得复制
bytes.Buffer或用io.TeeReader，别直接复用原始ResponseWriter的底层 buffer，容易脏读
为什么加了 Cache-Control: public, max-age=300 但 Postman 里还是每次都 200？
因为 Postman 默认不发 Cache-Control 请求头，也不读响应头做本地缓存；浏览器才按规范实现缓存逻辑。验证缓存是否生效，得看真实客户端行为，或用 curl -I 看响应头是否写出，再配合服务端日志确认 handler 是否被跳过。
另一个常见干扰是反向代理（Nginx、Cloudflare）默认不缓存非 200 响应，也不缓存带 Set-Cookie 的响应。如果你的接口返回了 Set-Cookie，即使加了 Cache-Control，代理层也会绕过缓存。
- 调试时，在 handler 开头加
log.Println("handler executed")，观察日志是否消失，比看状态码更可靠 - 用
curl -v http://localhost:8080/api/data查看Age响应头，大于 0 表示命中了某层缓存 - 不要依赖
Expires头，HTTP/1.1 以max-age为准；Expires是兼容 HTTP/1.0 的备用方案，容易因服务器时间偏差出错
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
