答案:通过实现自定义 RoundTripper 拦截请求,利用内存或外部存储缓存响应,结合 http 头控制缓存有效性,可高效实现golang HTTP 缓存。

在 golang 中实现 HTTP 请求缓存,核心思路是拦截或 封装HTTP 客户端行为,在发送请求前检查是否存在有效缓存,若有则直接返回缓存结果,否则发起真实请求并保存响应。以下是一些实用且常见的实现方式。
使用 中间件 式缓存结构
通过自定义 RoundTripper 接口 实现透明缓存,这种方式不会侵入业务代码,只需替换 http.Client 的传输层。
RoundTripper 接口定义了单个 HTTP 事务的执行逻辑,我们可以包装默认的http.Transport,在请求前后加入缓存判断。
示例:简易内存缓存实现
立即学习“go 语言免费学习笔记(深入)”;
type CacheTransport struct {transport http.RoundTripper cache map[string]cachedResponse mu sync.RWMutex } type cachedResponse struct {once sync.Once resp *http.Response bodyBytes []byte } func NewCacheTransport() *CacheTransport { return &CacheTransport{ transport: http.DefaultTransport, cache: make(map[string]cachedResponse), } } func (c *CacheTransport) RoundTrip(req *http.Request) (*http.Response, error) {key := req.Method + ":" + req.URL.String() c.mu.RLock() if cached, found := c.cache[key]; found {c.mu.RUnlock() // 返回缓存响应的副本,避免引用被修改 respCopy := cached.resp.Clone(req.Context()) body := bytes.NewReader(cached.bodyBytes) respCopy.Body = io.NopCloser(body) return respCopy, nil } c.mu.RUnlock() // 发起真实请求 resp, err := c.transport.RoundTrip(req) if err != nil {return nil, err} // 读取响应体并缓存 bodyBytes, err := io.ReadAll(resp.Body) if err != nil {resp.Body.Close() return nil, err } resp.Body.Close() respCopy := resp.Clone(req.Context()) respCopy.Body = io.NopCloser(bytes.NewReader(bodyBytes)) c.mu.Lock() c.cache[key] = cachedResponse{resp: respCopy, bodyBytes: bodyBytes,} c.mu.Unlock() return respCopy, nil}
使用方式:
client := &http.Client{Transport: NewCacheTransport(), } resp, err := client.Get("https://api.example.com/data")
控制缓存生命周期
实际应用中需考虑缓存过期机制。可基于 HTTP 标准头字段如 Cache-Control、Expires 或 Last-Modified 决定是否复用缓存。
- 解析Cache-Control: max-age=60,表示最多缓存 60 秒
- 若响应包含Expires,将其与当前时间比较
- 结合 ETag 或Last-Modified实现条件请求(如携带If-None-Match)
可在 CacheTransport 中增强逻辑:缓存时记录时间,读取时验证有效性,过期后可选择删除或发起 304 Not Modified 验证。
选择合适的缓存存储
内存缓存适用于单机场景,但重启即丢失。根据需求可扩展为:
- 本地磁盘 :使用boltdb 或badger持久化缓存数据
- redis:适合 分布式 服务共享缓存,支持 TTL 自动清理
- LRU 策略 :使用container/list 实现带容量限制的 LRU 缓存,防止内存无限增长
注意事项与优化建议
- 仅对 GET 等幂等方法启用缓存
- 注意请求头的影响(如Accept-Encoding),缓存键应包含关键头信息
- 处理 304 响应时复用旧缓存,并更新过期时间
- 避免缓存 Set-cookie等敏感头导致安全问题
- 生产环境建议使用成熟库如 gocache 或集成 fasthttp 生态组件
基本上就这些。通过组合 标准库 接口和合理设计,Golang 可以灵活实现高效 HTTP 缓存机制。


