Golang实现Web缓存策略技巧

本文深入讲解了在 Go 语言中高效实现 Web 缓存策略的核心技巧：强调以 `http.Handler` 封装缓存逻辑（推荐使用 `ristretto` 而非 `sync.Map`），必须通过自定义 `ResponseWriter` 拦截并缓存响应体，同时**关键指出缓存生效与否不取决于内存是否存储，而取决于服务端显式设置的 `Cache-Control`、`ETag` 和 `Last-Modified` 等 HTTP 响应头**；文章还提醒开发者警惕大响应体直入内存导致 OOM 的风险，给出基于成本（而非条数）的缓存容量控制方法，并用真实 curl 输出示例强调调试时应关注响应头而非日志打印——帮你避开 90% 的缓存失效陷阱。

用 http.Handler 包裹缓存逻辑最直接

Go 标准库没有内置 Web 缓存中间件，但你可以用一个闭包或结构体封装 http.Handler，在 ServeHTTP 中判断是否命中缓存。关键不是“加缓存”，而是“决定什么时候不走后端”。

func cacheHandler(next http.Handler, cache *ristretto.Cache) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        key := r.Method + ":" + r.URL.Path
        if val, ok := cache.Get(key); ok {
            if data, ok := val.([]byte); ok {
                w.Header().Set("X-Cache", "HIT")
                w.Write(data)
                return
            }
        }
        // 缓存未命中：捕获响应体再写入缓存
        rw := &responseWriter{ResponseWriter: w, body: &bytes.Buffer{}}
        next.ServeHTTP(rw, r)
        if rw.statusCode >= 200 && rw.statusCode 注意：必须用自定义 <code>ResponseWriter</code> 拦截响应体，否则无法缓存内容；<code>ristretto</code> 是目前 Go 生态中性能和并发安全兼顾得最好的内存缓存库，别用 <code>sync.Map</code> 手搓——它不支持 TTL 和容量淘汰。

<h3><code>Cache-Control</code> 头必须由服务端显式设置</h3>
<p>浏览器或 CDN 是否缓存，不取决于你内存里有没有数据，而取决于你返回的 HTTP 头。Go 默认不设 <code>Cache-Control</code>，所以即使你本地缓存了，客户端仍可能反复请求。</p><pre class="brush:php;toolbar:false">w.Header().Set("Cache-Control", "public, max-age=600")
w.Header().Set("ETag", fmt.Sprintf("%x", md5.Sum([]byte(content))))
w.Header().Set("Last-Modified", time.Now().UTC().Format(http.TimeFormat))

• max-age 单位是秒，设为 0 或 no-cache 表示“每次验证”
• 对静态资源（如 /static/js/app.js）建议用 immutable + 哈希文件名，避免手动控制
• ETag 和 Last-Modified 配合 If-None-Match/If-Modified-Since 实现协商缓存，但仅当内容不变时才省带宽，不省 CPU

高频小数据用 ristretto，大响应体慎缓存到内存

把整个 HTML 响应体塞进内存缓存，看似简单，实则危险：

• 10KB 响应 × 1000 并发 = 至少 10MB 内存，没做驱逐会 OOM
• ristretto 的 MaxCost 是按字节算成本，不是条数；设 MaxCost: 100 （100MB）比 NumCounters: 1e7 更靠谱
• 超过 50KB 的响应（比如带图表的报表页），更适合用 Redis 或 diskv 做外部缓存，内存只存元数据或短时效 key
• 不要缓存含用户身份信息的响应（如 /profile），除非你做了 per-user key 分离，且确认 session 未过期

测试缓存行为不能只看日志，要检查真实响应头

本地跑 curl -v http://localhost:8080/api/data，重点看三行：

> curl -v http://localhost:8080/api/data
如果 <code>X-Cache</code> 没出现，说明你的 handler 没生效；如果 <code>Cache-Control</code> 缺失，浏览器根本不会缓存；如果第二次请求没带 <code>If-None-Match</code>，说明前端没走协商流程。别依赖 <code>fmt.Println("cached!")</code>——它掩盖了响应头没写、中间件顺序错、指针被覆盖等真正问题。<p>文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Golang实现Web缓存策略技巧》文章吧，也可关注golang学习网公众号了解相关技术文章。</p>