Go HTTP服务需手动启用Gzip压缩,仅对text/html、text/css、application/javascript等文本类型响应压缩,检查Accept-Encoding头,使用gzip.DefaultCompression,避免Minify运行时处理,静态文件应预压缩并正确设置MIME与缓存头,gzip.Writer须确保Close调用且不复用。

Go HTTP服务怎么开启Gzip压缩
不加压缩的HTML/CSS/JS响应在传输中浪费带宽,尤其对移动端或弱网用户明显拖慢首屏。Go标准库net/http本身不自动压缩,必须手动包装ResponseWriter或用中间件。
最轻量、兼容性最好的做法是用gzip.NewWriter包裹响应体,配合Accept-Encoding头判断客户端是否支持:
- 只对
text/html、text/css、application/javascript等文本类型压缩,二进制(如image/png)加了反而更大 - 务必检查请求头是否含
gzip,否则可能把压缩后的内容发给不支持解压的老设备 - 压缩级别别设太高(如
gzip.BestCompression),CPU开销陡增,实测gzip.DefaultCompression性价比最优
func gzipHandler(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
if !strings.Contains(r.Header.Get("Accept-Encoding"), "gzip") {
next.ServeHTTP(w, r)
return
}
w.Header().Set("Content-Encoding", "gzip")
gz := gzip.NewWriter(w)
defer gz.Close()
gzr := &gzipResponseWriter{Writer: gz, ResponseWriter: w}
next.ServeHTTP(gzr, r)
})
}
Minify中间件为什么反而让页面变慢
很多人以为“Minify + Gzip”双管齐下效果更好,结果发现TTFB上升、CPU占用飙升——根本原因是Minify(如tdewolff/minify)默认对每个响应做实时解析+语法树重写,比单纯Gzip耗时高10–50倍。
它适合构建时预处理静态资源,不适合运行时处理动态HTML:
立即学习“go语言免费学习笔记(深入)”;
-
minify.Html().Minify()会逐字符解析、删空格、合并属性,对模板渲染后的HTML做这个操作纯属重复劳动 - Minify不缓存结果,每次请求都重跑,且不支持并发安全的复用实例(需自己加锁或池化)
- 压缩后的内容再经Gzip,收益极小(HTML本身已高度可压缩),但CPU成本翻倍
真实场景下,关掉运行时Minify,只保留Gzip,QPS通常能提升20%以上。
如何安全地为静态文件启用压缩
静态资源(/static/下的CSS/JS)可以提前Minify并存为.min.css,再由HTTP服务直接返回——这样既避免运行时开销,又确保内容最小化。
关键点在于路径匹配和MIME类型设置:
- 用
http.FileServer前先包装一层,拦截.css、.js请求,重写为.min.css路径(若存在) - 确保
Content-Type正确:JS必须是application/javascript,不是text/javascript(后者已被弃用,部分浏览器不触发Gzip) - 加上
Cache-Control: public, max-age=31536000,让CDN和浏览器缓存压缩后版本,彻底避开服务端重复处理
示例逻辑片段:if strings.HasSuffix(path, ".js") { path = strings.TrimSuffix(path, ".js") + ".min.js" }
gzip.Writer常见内存泄漏陷阱
直接用gzip.NewWriter(w)但没调用Close(),会导致底层bufio.Writer缓冲区未刷新,响应卡住或截断;更隐蔽的是,如果在defer gz.Close()前发生panic,gz对象可能永远不释放,连接堆积。
稳妥做法是封装一个带恢复机制的gzipResponseWriter:
- 在
WriteHeader()和Write()里加recover(),防止panic导致Close()跳过 - 不要复用
gzip.Writer实例(它不是goroutine-safe),每次请求新建 - 注意
Content-Length不能提前设——压缩后长度未知,必须删掉该header,让Go自动用chunked编码
这些细节不处理,上线后可能表现为偶发空白页或响应超时,查起来特别费时间。











