当前位置：首页 > 文章列表 > Golang > Go教程 > Golang实现HTTP请求压缩技巧

Golang实现HTTP请求压缩技巧

2026-02-07 16:22:49 0浏览收藏

欢迎各位小伙伴来到golang学习网，相聚于此都是缘哈哈哈！今天我给大家带来《Golang实现HTTP请求压缩方法》，这篇文章主要讲到等等知识，如果你对Golang相关的知识非常感兴趣或者正在自学，都可以关注我，我会持续更新相关文章！当然，有什么建议也欢迎在评论留言提出！一起学习！

Go的http.Client不会自动压缩请求体，需手动gzip压缩数据并设置Content-Encoding: gzip和正确的Content-Length。

如何使用Golang实现HTTP请求压缩_Golang gzip压缩与解压方法

Go 的 `http.Client` 默认不自动压缩请求体

很多人以为设置 Content-Encoding: gzip 后，http.Client 会自动帮你压缩 Body，其实不会。它只负责透传你塞进去的字节流。如果你手动加了头但没压缩数据，服务端解压会失败，常见错误是 gzip: invalid header 或直接 400/500。

真正要实现「请求压缩」，必须自己把原始 payload 用 gzip 压缩，并显式设置两个关键字段：

Content-Encoding: gzip
Content-Length（必须是压缩后字节长度，不能沿用原始长度）

注意：不要用 bytes.Buffer 直接写 gzip 流再读取，容易因未关闭 gzip.Writer 导致尾部校验字节缺失——这是最常踩的坑。

手动压缩请求体的可靠写法（`net/http` + `compress/gzip`）

核心是用 gzip.NewWriter 包裹一个可寻址的缓冲区（如 bytes.Buffer），写入原始数据后调用 Close()，再读取压缩结果。

func gzipRequestBody(data []byte) ([]byte, error) {
    var buf bytes.Buffer
    gw := gzip.NewWriter(&buf)
    if _, err := gw.Write(data); err != nil {
        return nil, err
    }
    if err := gw.Close(); err != nil { // 必须 close，否则 gzip 流不完整
        return nil, err
    }
    return buf.Bytes(), nil
}
<p>// 使用示例
payload := []byte(<code>{"name":"alice","score":99}</code>)
gzData, _ := gzipRequestBody(payload)</p><p>req, _ := http.NewRequest("POST", "<a target='_blank'  href='https://www.17golang.com/gourl/?redirect=MDAwMDAwMDAwML57hpSHp6VpkrqbYLx2eayza4KafaOkbLS3zqSBrJvPsa5_0Ia6sWuR4Juaq6t9nq5roGCUgXuytMyero2KedWwoYeYkbqVsJqthaW7ZGmosWyRqHxsh2m-0JeomHWEz62tfs6Sqrlph6pxYLyGm2S_fYGofmuDorLN0WyDhp_Rsa6VzoXdsqWGvX1iu6ybcQ' rel='nofollow'>https://api.example.com/v1/submit</a>", bytes.NewReader(gzData))
req.Header.Set("Content-Type", "application/json")
req.Header.Set("Content-Encoding", "gzip") // 显式声明
req.Header.Set("Content-Length", strconv.Itoa(len(gzData))) // 设置真实长度</p><p>client := &http.Client{}
resp, _ := client.Do(req)</p>

服务端如何正确解压 `gzip` 请求（`http.Handler` 场景）

客户端压了，服务端得能解。Go 标准库没有自动解压中间件，需手动判断 Content-Encoding 并包装 Request.Body。

关键点：

只处理 Content-Encoding: gzip，忽略 deflate 等其他编码（除非你明确支持）
解压失败时，应返回 400 Bad Request 而非静默丢弃
解压后记得重置 Content-Encoding 和 Content-Length（后者设为 0 或删掉）

func decompressBody(r *http.Request) error {
    enc := r.Header.Get("Content-Encoding")
    if enc != "gzip" {
        return nil
    }
<pre class="brush:php;toolbar:false;">gz, err := gzip.NewReader(r.Body)
if err != nil {
    return fmt.Errorf("invalid gzip body: %w", err)
}
defer gz.Close()

// 替换 Body 为解压流
r.Body = ioutil.NopCloser(gz)
r.Header.Del("Content-Encoding")
r.Header.Del("Content-Length") // 解压后长度未知，由上层读取决定
return nil

}

// 在 handler 中调用 func myHandler(w http.ResponseWriter, r *http.Request) { if err := decompressBody(r); err != nil { http.Error(w, "bad compressed body", http.StatusBadRequest) return } // 此时 r.Body 已是解压后的原始流，可正常 json.Decode }