在Golang的Web开发中，当接口返回的数据量较大时，启用gzip压缩可以显著减小响应体积，减少网络传输时间，提升客户端的接收效率。Golang的标准库已经提供了完整的gzip压缩支持，无需引入第三方依赖即可实现相关功能。
gzip压缩的基本原理
gzip是一种常用的文件压缩格式，HTTP协议支持通过Accept-Encoding请求头和Content-Encoding响应头来协商是否使用gzip压缩。客户端发送请求时携带Accept-Encoding: gzip，服务端收到请求后如果支持gzip压缩，就会对响应内容进行压缩，然后设置Content-Encoding: gzip返回给客户端，客户端收到后自动进行解压处理。
手动实现gzip压缩响应
我们可以通过标准库的compress/gzip包手动对响应内容进行压缩，以下是一个简单的示例，实现返回JSON数据时的gzip压缩：
package main
import (
"compress/gzip"
"encoding/json"
"net/http"
)
// 定义返回的数据结构
type ResponseData struct {
Code int `json:"code"`
Message string `json:"message"`
Data string `json:"data"`
}
func gzipHandler(w http.ResponseWriter, r *http.Request) {
// 检查客户端是否支持gzip压缩
if !strings.Contains(r.Header.Get("Accept-Encoding"), "gzip") {
// 不支持则直接返回未压缩的内容
writeUncompressed(w)
return
}
// 设置响应头，告知客户端内容是gzip压缩的
w.Header().Set("Content-Encoding", "gzip")
w.Header().Set("Content-Type", "application/json")
// 创建gzip写入器
gz := gzip.NewWriter(w)
defer gz.Close()
// 构造返回数据
resp := ResponseData{
Code: 200,
Message: "success",
Data: "这是一段需要返回的长文本内容，压缩后体积会明显减小",
}
// 将数据编码为JSON并写入gzip写入器
jsonData, err := json.Marshal(resp)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
gz.Write(jsonData)
}
func writeUncompressed(w http.ResponseWriter) {
w.Header().Set("Content-Type", "application/json")
resp := ResponseData{
Code: 200,
Message: "success",
Data: "这是一段需要返回的长文本内容，压缩后体积会明显减小",
}
json.NewEncoder(w).Encode(resp)
}
func main() {
http.HandleFunc("/api/data", gzipHandler)
http.ListenAndServe(":8080", nil)
}
上述代码中，我们首先判断客户端是否支持gzip压缩，如果支持就创建gzip.Writer对响应内容进行压缩，同时设置对应的响应头。需要注意的是，gzip.Writer使用完毕后需要关闭，否则可能导致压缩数据不完整。
使用中间件封装gzip压缩逻辑
如果项目中多个接口都需要启用gzip压缩，手动在每个接口中编写压缩逻辑会非常冗余，我们可以通过中间件的方式统一处理：
package main
import (
"compress/gzip"
"net/http"
"strings"
)
// 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") {
// 设置响应头
w.Header().Set("Content-Encoding", "gzip")
// 创建gzip写入器
gz := gzip.NewWriter(w)
defer gz.Close()
// 自定义ResponseWriter，将写入的内容转发到gzip写入器
gzWriter := &GzipResponseWriter{Writer: gz, ResponseWriter: w}
next.ServeHTTP(gzWriter, r)
return
}
next.ServeHTTP(w, r)
})
}
// 自定义ResponseWriter，实现http.ResponseWriter接口
type GzipResponseWriter struct {
http.ResponseWriter
Writer *gzip.Writer
}
func (g *GzipResponseWriter) Write(b []byte) (int, error) {
return g.Writer.Write(b)
}
func helloHandler(w http.ResponseWriter, r *http.Request) {
w.Header().Set("Content-Type", "text/plain; charset=utf-8")
w.Write([]byte("Hello, this is a test response that will be compressed by gzip if client supports it."))
}
func main() {
// 将中间件应用到路由上
mux := http.NewServeMux()
mux.HandleFunc("/hello", helloHandler)
handler := GzipMiddleware(mux)
http.ListenAndServe(":8080", handler)
}
这个中间件会自动判断每个请求的客户端是否支持gzip压缩，如果支持就自动对响应内容进行压缩，无需在每个接口中重复编写压缩逻辑。
注意事项
- 不要对已经压缩过的内容（如图片、视频、zip包等）再次进行gzip压缩，否则不仅不会减小体积，还会增加CPU开销。
- 如果响应内容本身很小（比如只有几十字节），压缩后的体积可能反而更大，此时可以设置阈值，只有响应内容超过一定大小时才启用压缩。
- 使用
gzip.Writer时务必调用Close方法，否则压缩数据可能不会被完整写入。 - 如果使用的是Golang的第三方Web框架，部分框架已经内置了gzip中间件，可以直接配置使用，无需自己实现。
压缩效果对比
我们可以通过一个简单的测试对比压缩前后的响应体积，假设返回的JSON数据大小为10KB，启用gzip压缩后体积通常会减小到原来的30%左右，具体压缩率取决于内容的可压缩性。以下是不同内容类型的常见压缩率参考：
| 内容类型 | 原始大小 | gzip压缩后大小 | 压缩率 |
|---|---|---|---|
| 纯文本JSON | 10KB | 3KB | 70% |
| HTML页面 | 20KB | 5KB | 75% |
| CSS文件 | 15KB | 4KB | 73% |
通过合理使用gzip压缩，可以在几乎不增加额外开发成本的情况下，有效提升接口的传输效率，尤其是在返回大量文本数据的场景中效果非常明显。