0

0

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

P粉602998670

P粉602998670

发布时间:2026-01-06 14:44:02

|

344人浏览过

|

来源于php中文网

原创

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(),再读取压缩结果。

立即学习go语言免费学习笔记(深入)”;

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
}

// 使用示例 payload := []byte({"name":"alice","score":99}) gzData, _ := gzipRequestBody(payload)

req, _ := http.NewRequest("POST", "https://www.php.cn/link/d023b1ef80754864db9e412e1fd955ac", 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))) // 设置真实长度

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

服务端如何正确解压 gzip 请求(http.Handler 场景)

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

蛙蛙写作——超级AI智能写作助手
蛙蛙写作——超级AI智能写作助手

蛙蛙写作辅助AI写文,帮助获取创意灵感,提供拆书、小说转剧本、视频生成等功能,是一款功能全面的AI智能写作工具。

下载

关键点:

  • 只处理 Content-Encoding: gzip,忽略 deflate 等其他编码(除非你明确支持)
  • 解压失败时,应返回 400 Bad Request 而非静默丢弃
  • 解压后记得重置 Content-EncodingContent-Length(后者设为 0 或删掉)
func decompressBody(r *http.Request) error {
    enc := r.Header.Get("Content-Encoding")
    if enc != "gzip" {
        return nil
    }
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 }

别用 http.TransportDisableCompression 来“启用压缩”

这个字段名字极具误导性:DisableCompression 控制的是 **响应体** 是否自动解压(即是否透传 Content-Encoding: gzip 的响应),跟请求体完全无关。设成 false 不会让请求变压缩,设成 true 也不会阻止你手动发压缩请求。

常见误操作:

  • 以为设置了 transport.DisableCompression = false 就能“开启请求压缩” → 实际毫无影响
  • 在请求里漏掉 Content-Encoding 头,却指望 transport 自动补 → 不会
  • io.Pipe 配合 gzip.Writer 流式上传大文件,但没处理好 reader goroutine 的生命周期 → 容易死锁

真正需要流式压缩上传(比如上传大日志文件),应该用 io.MultiReader 或显式启动 goroutine 控制 gzip.Writer 写入,而不是依赖 transport。

相关专题

更多
golang如何定义变量
golang如何定义变量

golang定义变量的方法:1、声明变量并赋予初始值“var age int =值”;2、声明变量但不赋初始值“var age int”;3、使用短变量声明“age :=值”等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

177

2024.02.23

golang有哪些数据转换方法
golang有哪些数据转换方法

golang数据转换方法:1、类型转换操作符;2、类型断言;3、字符串和数字之间的转换;4、JSON序列化和反序列化;5、使用标准库进行数据转换;6、使用第三方库进行数据转换;7、自定义数据转换函数。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

226

2024.02.23

golang常用库有哪些
golang常用库有哪些

golang常用库有:1、标准库;2、字符串处理库;3、网络库;4、加密库;5、压缩库;6、xml和json解析库;7、日期和时间库;8、数据库操作库;9、文件操作库;10、图像处理库。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

336

2024.02.23

golang和python的区别是什么
golang和python的区别是什么

golang和python的区别是:1、golang是一种编译型语言,而python是一种解释型语言;2、golang天生支持并发编程,而python对并发与并行的支持相对较弱等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

208

2024.03.05

golang是免费的吗
golang是免费的吗

golang是免费的。golang是google开发的一种静态强类型、编译型、并发型,并具有垃圾回收功能的开源编程语言,采用bsd开源协议。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

388

2024.05.21

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

194

2025.06.09

golang相关判断方法
golang相关判断方法

本专题整合了golang相关判断方法,想了解更详细的相关内容,请阅读下面的文章。

189

2025.06.10

golang数组使用方法
golang数组使用方法

本专题整合了golang数组用法,想了解更多的相关内容,请阅读专题下面的文章。

191

2025.06.17

Golang 分布式缓存与高可用架构
Golang 分布式缓存与高可用架构

本专题系统讲解 Golang 在分布式缓存与高可用系统中的应用,涵盖缓存设计原理、Redis/Etcd集成、数据一致性与过期策略、分布式锁、缓存穿透/雪崩/击穿解决方案,以及高可用架构设计。通过实战案例,帮助开发者掌握 如何使用 Go 构建稳定、高性能的分布式缓存系统,提升大型系统的响应速度与可靠性。

27

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号