通过Gzip压缩与HTTP缓存优化Golang静态文件传输：先实现gzip中间件压缩文本资源，再设置Cache-Control长期缓存，结合ETag和文件名哈希确保高效加载与及时更新。
在Golang开发Web服务时，静态文件（如CSS、JS、图片等）的传输效率直接影响页面加载速度和用户体验。通过实现静态文件的压缩与缓存，可以显著减少网络传输体积、降低服务器带宽消耗，并提升响应性能。本文介绍如何在Golang中实践静态文件的Gzip压缩与HTTP缓存控制。
启用静态文件的Gzip压缩
HTTP压缩能有效减小文本类静态资源的体积，尤其对CSS、JavaScript、HTML等文本文件效果明显。Golang标准库虽未直接提供Gzip中间件，但可通过compress/gzip包手动实现。
实现方式：编写一个包装http.Handler的中间件，在支持gzip的客户端请求下，将响应内容压缩后再发送。
package main
import (
"compress/gzip"
"io"
"net/http"
"strings"
)
// gzipMiddleware 支持gzip压缩的中间件
func gzipMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
// 判断客户端是否支持gzip
if !strings.Contains(r.Header.Get("Accept-Encoding"), "gzip") {
next.ServeHTTP(w, r)
return
}
// 创建gzip writer
gz := gzip.NewWriter(w)
defer gz.Close()
// 包装ResponseWriter，替换Write方法
w.Header().Set("Content-Encoding", "gzip")
w.Header().Del("Content-Length") // 压缩后长度变化，需删除原长度头
gw := gzipResponseWriter{Writer: gz, ResponseWriter: w}
next.ServeHTTP(gw, r)
})
}
// 包装http.ResponseWriter以拦截Write调用
type gzipResponseWriter struct {
io.Writer
http.ResponseWriter
}
func (w gzipResponseWriter) Write(b []byte) (int, error) {
return w.Writer.Write(b)
}
使用该中间件包裹静态文件服务：
立即学习“go语言免费学习笔记（深入）”；
fs := http.FileServer(http.Dir("static/"))
http.Handle("/static/", gzipMiddleware(fs))
注意：仅对文本类型资源启用压缩，图片、视频、已压缩文件（如woff2）无需再压缩。
设置合理的HTTP缓存策略
利用浏览器缓存可避免重复请求静态资源。常用机制包括Cache-Control、ETag和Last-Modified。
1. 使用 Cache-Control 设置强缓存
对于带有版本号或哈希值的静态资源（如app.a1b2c3.js），可设置长期缓存。
func cacheControlMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if strings.HasSuffix(r.URL.Path, ".js") ||
strings.HasSuffix(r.URL.Path, ".css") {
w.Header().Set("Cache-Control", "public, max-age=31536000, immutable")
} else if strings.HasSuffix(r.URL.Path, ".png") ||
strings.HasSuffix(r.URL.Path, ".jpg") {
w.Header().Set("Cache-Control", "public, max-age=604800")
}
next.ServeHTTP(w, r)
})
}
2. 启用 ETag 支持协商缓存
Golang的http.FileServer默认会根据文件修改时间和大小生成ETag。当客户端发送If-None-Match时，若ETag未变，则返回304 Not Modified。
确保文件系统稳定，避免ETag因时间精度问题频繁变更。也可自定义ETag生成逻辑，例如基于文件哈希：
hash := sha256.Sum256([]byte(fmt.Sprintf("%s-%d", filepath, info.ModTime().Unix())))
etag := fmt.Sprintf("\"%x\"", hash[:10])
结合文件名哈希实现缓存更新
为解决用户端缓存过期问题，推荐在构建阶段为静态文件添加内容哈希，如main.abcd1234.js。这样每次内容变更，文件名随之改变，浏览器会重新下载。
在Go模板中动态引入带哈希的文件名，可通过构建时生成映射表（asset manifest）实现：
// assets.go
var AssetMap = map[string]string{
"main.js": "main.abcd1234.js",
}
// 模板中使用
配合长期缓存策略，既能保证资源高效复用，又能及时更新最新版本。
基本上就这些。通过压缩+缓存+哈希命名的组合策略，可以在Golang Web服务中有效优化静态文件的传输性能，不复杂但容易忽略细节。
