Go 文件缓存分内存层(map+sync.RWMutex 或第三方库)和 HTTP 层(ETag/Last-Modified/Cache-Control),协同降低 IO 压力与带宽消耗;内存缓存适用于中小规模静态文件,需配合过期清理与写时失效。

用 Go 实现文件缓存,核心是分两层:内存中快速读取热数据(如 map + sync.RWMutex 或第三方库),再配合 HTTP 协议级缓存(如 ETag、Last-Modified、Cache-Control)减少重复传输。两者结合,既降低磁盘 /IO 压力,又节省带宽、提升响应速度。
内存缓存:轻量级文件内容缓存
适合中小规模、读多写少的静态文件(如配置模板、小图标、JSON Schema)。不建议缓存大文件(如 >10MB),避免内存溢出。
- 用
sync.Map或带读写锁的map[string][]byte存储文件路径 → 内容 字节 切片 - 读取时先查内存,命中则直接返回;未命中则读文件、写入缓存、再返回
- 加简单过期机制:启动 goroutine 定期清理(如每 5 分钟扫描时间戳超时项),或使用
time.AfterFunc为每个条目设延迟清理 - 注意:Go 标准库 没有内置带过期的内存缓存,可考虑
github.com/patrickmn/go-cache或github.com/bluele/gcache等成熟封装
HTTP 缓存:让客户端和服务端协同省流量
关键不是“服务端存不存”,而是告诉 浏览器/ 代理“什么时候可以复用旧响应”。Go 的 http.ServeFile 默认不设缓存头,需手动补充。
- 对静态文件响应,设置
Cache-Control: public, max-age=3600(1 小时可复用) - 配合
ETag(内容哈希)或Last-Modified(文件修改时间),在GET请求带If-None-Match或If-Modified-Since时,返回304 Not Modified - 示例:用
http.FileServer包裹自定义FileSystem,重写Open方法,在http.File返回前写入缓存头和 ETag - 注意:若文件可能被外部进程修改(非 Go 应用写入),务必用
os.Stat().ModTime()或md5.Sum(fileBytes)动态生成 ETag,不能硬 编码
组合策略:内存 + HTTP 缓存联动
内存缓存加速服务端读取,HTTP 缓存减少网络往返——二者正交,可同时启用。
立即学习“go 语言免费学习笔记(深入)”;
- 请求到达:先查内存缓存,有则取出内容 + 计算 ETag(如
fmt.Sprintf("%x", md5.Sum(content))) - 对比请求头中的
If-None-Match,匹配则直接写304,不读磁盘也不传正文 - 不匹配则写
200响应,附上ETag和Cache-Control头 - 若内存未命中,再读磁盘 → 写入内存缓存 → 同上流程返回
- 写操作(如上传覆盖文件)时,记得从内存缓存中删除对应 key,保证一致性
基本上就这些。不需要复杂框架,标准库 + 少量逻辑就能搭出高效文件缓存。重点是理清“谁在什么环节决定是否走缓存”——内存层管服务端效率,HTTP 层管客户端行为,各司其职。