GolangHTTP请求压缩解压技巧

Go语言标准库原生支持HTTP请求与响应的压缩传输，开发者无需依赖第三方库即可高效实现gzip压缩与解压：客户端需手动压缩请求体并设置`Content-Encoding: gzip`头，而响应解压则由`net/http`默认自动完成；服务端则需通过中间件主动解析请求头进行解压，并根据`Accept-Encoding`头手动压缩响应体、添加相应头部。掌握这些核心机制，配合正确的资源管理和错误处理，就能在不牺牲可维护性的前提下显著提升API数据传输效率。

Go语言标准库提供了对HTTP请求压缩与解压的原生支持，开发者无需引入第三方库即可实现高效的数据压缩传输。关键在于正确设置请求头和处理响应体的gzip解码。

客户端发送压缩请求

Go默认不会压缩请求体，但可以通过手动启用gzip压缩来减少上传数据量。适用于POST、PUT等携带大量数据的请求。

步骤如下：

• 使用compress/gzip包创建gzip.Writer
• 将原始数据写入gzip.Writer进行压缩
• 设置请求头Content-Encoding: gzip
• 发送压缩后的数据

var buf bytes.Buffer
gz := gzip.NewWriter(&buf)
gz.Write([]byte("your large payload"))
gz.Close()

req, _ := http.NewRequest("POST", "http://example.com", &buf)
req.Header.Set("Content-Encoding", "gzip")
req.Header.Set("Content-Type", "application/json")

client := &http.Client{}
resp, _ := client.Do(req)

客户端自动解压响应

net/http包默认启用了对gzip和deflate响应的自动解压功能。只要服务端返回的响应头包含Content-Encoding: gzip，Client.Do会自动解压Body内容。

你只需要像处理普通响应一样读取Body即可：

resp, _ := http.Get("http://api.example.com/data")
body, _ := io.ReadAll(resp.Body)
// body已经是解压后的数据

若需关闭自动解压，可自定义Transport：

client := &http.Client{
    Transport: &http.Transport{
        DisableCompression: true,
    },
}

服务端支持请求解压

服务端需要主动检查请求头中的Content-Encoding，并对Body进行相应解压。

常见做法：

• 判断请求头是否包含Content-Encoding: gzip
• 若存在，用gzip.NewReader解压r.Body
• 后续逻辑统一处理解压后的数据流

func gzipMiddleware(next http.HandlerFunc) http.HandlerFunc {
    return func(w http.ResponseWriter, r *http.Request) {
        if r.Header.Get("Content-Encoding") == "gzip" {
            reader, err := gzip.NewReader(r.Body)
            if err != nil {
                http.Error(w, "invalid gzip", http.StatusBadRequest)
                return
            }
            defer reader.Close()
            r.Body = reader
        }
        next(w, r)
    }
}

服务端响应压缩

Go标准库不自动压缩响应，需手动实现。可通过包装ResponseWriter拦截Write调用，并根据Accept-Encoding决定是否启用gzip压缩。

基本思路：

• 检查请求头Accept-Encoding是否支持gzip
• 若支持，设置响应头Content-Encoding: gzip
• 使用gzip.Writer包装原始响应流
• 将后续Write的数据压缩输出

可借助第三方库如github.com/gin-gonic/contrib/gzip（Gin框架）或自行实现中间件。

今天关于《GolangHTTP请求压缩解压技巧》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！