尧图网络 高端网站定制 · 原创设计
免费咨询热线
400-888-6620
免费获取方案
Python POST 请求压缩上传数据
前言日常开发中使用 Python 调用 HTTP POST 接口时如果上传报文体积较大大量 JSON、批量数据、文本内容未压缩的数据会占用更多带宽增加网络耗时高并发场景下还会提升服务器流量压力。很多开发者熟悉服务端返回压缩响应Accept-Encoding却很少了解客户端同样可以将请求 Body 压缩后上传。本文讲解 HTTP 请求体压缩原理提供requests、httpx、aiohttp完整实现代码并梳理常见踩坑点。关键概念区分Accept-Encoding: gzip, deflate告诉服务端客户端支持接收压缩响应下行压缩绝大多数库自动支持Content-Encoding: gzip告诉服务端当前 POST 请求 Body已经被压缩上行压缩需要手动实现⚠️ 重要前提服务端必须实现对应解压逻辑。若后端没有处理Content-Encoding请求头直接接收压缩二进制流会出现解析报错。一、实现原理将原始报文JSON/二进制文本序列化为字节使用 gzip/deflate 算法压缩字节数据请求头增加Content-Encoding: gzipPOST 使用data/content参数传入压缩后的二进制禁止使用 json 参数HTTP 自动填充Content-Length无需手动计算。推荐算法gzip跨语言、各后端框架兼容性最优。二、requests 同步实现最常用importrequestsimportgzipimportjsonfromioimportBytesIOdefgzip_compress(raw_data:bytes)-bytes:gzip压缩字节数据bufferBytesIO()withgzip.GzipFile(fileobjbuffer,modewb)asfp:fp.write(raw_data)returnbuffer.getvalue()if__name____main__:urlhttp://127.0.0.1:8000/api/uploadpayload{list:list(range(2000)),content:大量测试文本*500}# 序列化为JSON字节raw_bytesjson.dumps(payload,ensure_asciiFalse).encode(utf-8)# 阈值判断过小的数据不压缩避免压缩头部导致体积变大compress_threshold2048headers{Content-Type:application/json; charsetutf-8}iflen(raw_bytes)compress_threshold:bodygzip_compress(raw_bytes)headers[Content-Encoding]gzipelse:bodyraw_bytes resprequests.post(url,headersheaders,databody)print(状态码,resp.status_code)print(响应内容,resp.text)避坑不要使用requests.post(..., jsonpayload)json 参数内部会自动编码无法传入压缩后的二进制数据必须使用data。三、httpx 同步/异步实现新项目推荐importhttpximportgzipimportjsonfromioimportBytesIOdefgzip_compress(raw_data:bytes)-bytes:bufferBytesIO()withgzip.GzipFile(fileobjbuffer,modewb)asfp:fp.write(raw_data)returnbuffer.getvalue()defsync_request():urlhttp://127.0.0.1:8000/api/uploadpayload{data:list(range(3000))}raw_bytesjson.dumps(payload).encode(utf-8)compressedgzip_compress(raw_bytes)headers{Content-Type:application/json; charsetutf-8,Content-Encoding:gzip}withhttpx.Client()asclient:rclient.post(url,headersheaders,contentcompressed)print(r.status_code,r.text)# 异步版本importasyncioasyncdefasync_request():urlhttp://127.0.0.1:8000/api/uploadpayload{data:list(range(3000))}raw_bytesjson.dumps(payload).encode(utf-8)compressedgzip_compress(raw_bytes)headers{Content-Type:application/json; charsetutf-8,Content-Encoding:gzip}asyncwithhttpx.AsyncClient()asclient:rawaitclient.post(url,headersheaders,contentcompressed)print(r.status_code,r.text)if__name____main__:sync_request()# asyncio.run(async_request())四、aiohttp 异步实现importaiohttpimportasyncioimportgzipimportjsonfromioimportBytesIOdefgzip_compress(raw_data:bytes)-bytes:bufferBytesIO()withgzip.GzipFile(fileobjbuffer,modewb)asfp:fp.write(raw_data)returnbuffer.getvalue()asyncdefmain():urlhttp://127.0.0.1:8000/api/uploadpayload{data:list(range(3000))}raw_bytesjson.dumps(payload).encode(utf-8)compressed_bodygzip_compress(raw_bytes)headers{Content-Type:application/json; charsetutf-8,Content-Encoding:gzip}asyncwithaiohttp.ClientSession()assession:asyncwithsession.post(url,datacompressed_body,headersheaders)asresp:print(status:,resp.status)print(awaitresp.text())if__name____main__:asyncio.run(main())五、配套服务端简易解压示例FastAPI测试时需要后端支持解压附上最简示例fromfastapiimportFastAPI,RequestimportgzipimportjsonfromioimportBytesIO appFastAPI()app.post(/api/upload)asyncdefupload(request:Request):headersrequest.headers bodyawaitrequest.body()# 判断是否gzip压缩ifheaders.get(Content-Encoding)gzip:bufBytesIO(body)withgzip.GzipFile(fileobjbuf)asf:bodyf.read()datajson.loads(body)return{msg:接收成功,data:data}六、常见问题与优化建议1. 小数据不要强行压缩gzip 自带固定头部十几字节报文很小的时候压缩后体积可能大于原始数据。建议设置阈值2KB左右超过阈值再开启压缩。2. Content-Type 不要删除Content-Encoding只是标记编码方式不能替代 Content-Type。JSON 请求依旧保留application/json。3. 代理、网关兼容性问题部分老旧反向代理、防火墙不识别Content-Encoding可能直接丢弃请求。上线前务必做连通性测试。4. 区分上行压缩与下行压缩很多人混淆两个头Accept-Encoding客户端声明能接收压缩响应下载Content-Encoding请求体已经压缩上传requests、httpx 默认自带 Accept-Encoding响应自动解压无需手动处理。5. 二进制文件场景不仅限于 JSON上传文本、CSV 等均可使用同样逻辑如果是图片、视频等本身已压缩的文件再次 gzip 收益极低不建议二次压缩。七、适用场景总结✅ 适合批量上报接口、大量JSON文本、日志上报、大数据同步❌ 不适合极小报文、图片/视频等已压缩媒体文件当接口传输量大、网络带宽有限、跨机房调用时开启请求体压缩能有效降低传输耗时减少流量开销。
RELATED

相关推荐

【Visual Studio】建立C++工程Hello Word

【Visual Studio】建立C++工程Hello Word

IDE版本:Visual Studio Professional 2019 V16.2.3创建工程 点击文件(File)——新建(New)——项目(Project) 快捷键:CtrlShiftN选择Console App进入下一步。为项目名目,并…

📅 2026/11/6 1:52:19
重入锁及实现原理

重入锁及实现原理

可重入锁,从字面来理解,就是可以重复进入的锁。可重入锁,也叫做递归锁,指的是同一线程外层函数获得锁之后,内层递归函数仍然有获取该锁的代码,但不受影响。在JAVA环境下ReentrantLock和synchronized都是可重…

📅 2026/10/14 13:22:19
Binge-和时间做朋友

Binge-和时间做朋友

Binge-和时间做朋友 引言:时间的悖论在技术世界中,我们常常陷入一种矛盾:一方面追求即时反馈,希望每一行代码都能立即运行;另一方面,又渴望构建能经得起时间考验的稳定系统。这种矛盾源于我们对时间的误解—…

📅 2026/9/19 21:27:37
MORE NEWS

更多资讯

📰

别踩坑!昭苏低压电工证考证学历不高怕报不上名?这几点你必须知道

别踩坑!昭苏低压电工证考证学历不高怕报不上名?这几点你必须知道 你是不是也这样,学历不高,担心自己考不了昭苏低压电工证?别急,这期咱们就来聊聊昭苏低压电工证考证的那些事儿,带你避开那些 千万别踩坑 的雷区。…

📰

铁路局电工证查询怎么考?学历不高怕报不上名?多少钱能拿下?

铁路局电工证查询怎么考?学历不高怕报不上名?多少钱能拿下? 你是不是学历不高,担心自己没资格考电工证?其实别担心, 铁路局电工证查询 并不难,关键是要知道怎么走流程。而且, 多少钱…

📰

电工证 没有检该怎办,考前押题怎么找?别再被中介骗了!

电工证 没有检该怎办,考前押题怎么找?别再被中介骗了! 你是不是也遇到过这种情况,电工证没检到,不知道从哪开始补办,生怕被中介骗钱?其实,只要掌握正确的方法,报名、考试、复审都能自己搞定,关键是要知道 考前押题…

📰

办理考电工证需要写字嘛需要什么材料

之前考的证在外省能不能转过来 电工证含金量到底咋样 之前考的证在外省能不能转过来?这个问题是很多正在准备考电工证或者已经持有电工证的朋友们最关心的。特别是在河南地区,很多人在外地工作,考的证又想在当地用,结果发现转证流程复杂,甚至不知道…

📰

电工证考试熔断器检查怎么过?考前押题帮你避开报名坑

电工证考试熔断器检查怎么过?考前押题帮你避开报名坑 不知道去哪报名怕被中介坑?电工证考试熔断器检查内容看似简单,但一不小心就会被细节卡住。尤其对于在开封项目现场做管理员的朋友,不仅得了解考试内容,还得知道怎么报名、怎么避免被坑。别急,本文帮…

📰

电工证快速办理江阴在哪考?工地太忙根本没时间复习考试

电工证快速办理江阴在哪考?工地太忙根本没时间复习考试 工地太忙根本没时间复习考试,这是大多数一线建筑工人的真实写照。尤其是像江阴这样的制造业和建筑大市,电工证已成为很多工人的“刚需”,但真正能抽出时间去准备考试的人却少之又少。你是不是也在担…

TODAY

今日更新

THIS WEEK

本周精选

THIS MONTH

本月热门

读完文章,想聊聊您的网站?

告诉我们您的行业与需求,资深顾问一对一梳理方案与报价,全程免费。

📞 💬