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

在Golang中实现HTTP请求缓存,核心思路是拦截或封装HTTP客户端行为,在发送请求前检查是否存在有效缓存,若有则直接返回缓存结果,否则发起真实请求并保存响应。以下是一些实用且常见的实现方式。
使用中间件式缓存结构
通过自定义RoundTripper接口实现透明缓存,这种方式不会侵入业务代码,只需替换http.Client的传输层。
RoundTripper 接口定义了单个HTTP事务的执行逻辑,我们可以包装默认的http.Transport,在请求前后加入缓存判断。
示例:简易内存缓存实现使用map存储响应,配合读写锁保证并发安全。
立即学习“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生态组件










