Go语言实现HTTP响应压缩教程

Go语言默认不启用HTTP响应压缩，导致传输明文数据、浪费带宽并拖慢页面加载速度；本文手把手教你如何通过一行代码集成gorilla/handlers.CompressHandler中间件，轻松实现自动化的Gzip/Brotli压缩——它智能协商客户端支持的编码格式、跳过小响应以避免压缩开销，是新手友好且生产环境可直接落地的高效解决方案。

Go 默认不压缩 HTTP 响应，必须手动介入或借助中间件；否则客户端收到的永远是明文，浪费带宽、拖慢首屏。

用 gorilla/handlers.CompressHandler 一行启用（推荐新手）

这是最省心、生产可用的方案。它自动处理 Accept-Encoding 协商、跳过小响应（默认 Content-Encoding 和 Vary 头。

• 无需自己判断请求头是否含 gzip，也不用重写 WriteHeader 或管理 gzip.Writer 生命周期
• 它包装的是整个 http.Handler，所以对所有路由生效，包括静态文件和 JSON API
• 注意：它不修改原始 ResponseWriter 的 Content-Length —— 因为压缩后长度不确定，所以会自动删掉该 header，由底层 transport 计算并发送 Transfer-Encoding: chunked

import "github.com/gorilla/handlers"

http.ListenAndServe(":8080", handlers.CompressHandler(yourMux))

手动实现 gzip.Writer 包装（适合定制或学习）

核心是创建一个自定义 ResponseWriter，在 Write 前把数据送进 gzip.Writer，并在结束时调用 Close() 刷出尾部元数据。

• 必须在第一次 Write 前设置 w.Header().Set("Content-Encoding", "gzip")，否则违反 HTTP 规范
• 必须设置 w.Header().Set("Vary", "Accept-Encoding")，否则 CDN 或代理可能缓存错版本
• 不能对已写 header 的响应再压缩（比如先调了 w.WriteHeader(200) 再想压），此时 Header() 已锁定
• gzip.NewWriter 默认压缩级别是 gzip.DefaultCompression（-1），如需更高压缩率可显式调用 gz.SetLevel(gzip.BestCompression)，但会增加 CPU 开销

为什么 io.Copy(gz, r.Body) + gz.Close() 缺一不可

这不是“习惯写法”，而是 gzip 格式强制要求：CRC32 校验和与原始未压缩长度（ISIZE）只在 Close() 时写入流末尾。漏掉 Close()，解压端会报 gzip: invalid checksum 或 invalid header。

• io.Copy(gz, r.Body) 是流式搬运，边读边压，内存友好
• 若只 io.Copy 不 Close，bytes.Buffer.Bytes() 返回的数据缺少尾部，一定解压失败
• 若你后续要把压缩结果存 Redis（如 HSET cache:key body），返回的 []byte 必须是完整 gzip 流，否则 redis-cli --raw get key | gunzip 会失败

常见错误：对已解压的 resp.Body 二次解压

Go 的 http.Client 默认开启自动解压 —— 只要服务端返回 Content-Encoding: gzip，resp.Body 就已经是解压后的明文。此时再用 gzip.NewReader(resp.Body)，必然触发 gzip: invalid header panic。

• 验证方式：打印 resp.Header.Get("Content-Encoding")，如果是 gzip，那你的 resp.Body 已经不是 gzip 流
• 只有当你手动设置了 &http.Transport{DisableCompression: true}，才需要自己解压 resp.Body
• 服务端收到带 Content-Encoding: gzip 的请求时，才需要自己调 gzip.NewReader(r.Body) —— 客户端发、服务端收，这个链路才是手动压缩/解压闭环

压缩不是加个头就完事，关键在流控制、头协商、尾部元数据三者同步；最容易被忽略的，就是那个看似多余的 gz.Close() —— 它不光是释放资源，更是生成合法 gzip 文件的最后一步。

好了，本文到此结束，带大家了解了《Go语言实现HTTP响应压缩教程》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！