如何利用Python的Gzip压缩减少Web接口响应的数据传输量?

P粉602998670

P粉602998670

2026-07-11

414人浏览

原创

django应使用gzipmiddleware而非django-compressor实现响应压缩,因前者压缩http响应体,后者仅优化静态资源;生产环境需显式配置gzip_min_length=1024、gzip_content_types包含application/json,并确保中间件位于commonmiddleware之后、securitymiddleware之前。

如何利用python的gzip压缩减少web接口响应的数据传输量?

直接上结论:用 flask-compressGZipMiddleware,别手写压缩逻辑——90% 的错误来自手动控制 Content-EncodingVary 头或忽略响应体长度阈值。

Flask 里启用 gzip 压缩只需三步,但第二步最容易漏

安装扩展、初始化、检查 MIME 类型白名单——缺一不可。

  • 安装:pip install flask-compress
  • 初始化必须在 app 实例创建后、路由注册前执行:Compress().init_app(app);放在 if __name__ == "__main__" 里就晚了
  • 默认只压 text/htmlapplication/json 等类型;若接口返回 application/vnd.api+json 或自定义 MIME,得显式配置:app.config['COMPRESS_MIMETYPES'] = ['text/html', 'application/json', 'application/vnd.api+json']

Django 中间件压缩不生效?先看这四个条件是否同时满足

GZipMiddleware 是开关,不是魔法——它只对同时满足以下四点的响应生效:

  • 状态码是 200(4xx/5xx 不压)
  • 响应体原始字节长度 > 200(小于等于 200 字节跳过,避免小数据越压越大)
  • Content-TypeGZIP_CONTENT_TYPES 白名单内(默认不含 application/javascript
  • 请求头含 Accept-Encoding: gzip(浏览器或客户端没发这个头,中间件直接绕过)

调试时用 curl -I -H "Accept-Encoding: gzip" http://localhost:8000/api/ 看响应头有没有 Content-Encoding: gzip,没有就逐条核对上面四点。

requests 自动解压失效时,常见原因不是 gzip 没开,而是头被覆盖

你看到 response.content 是乱码,response.text 却正常?说明 requests 已经解压过了。真正的问题常出现在上游:

Python 3.14.2
Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本,属于3.14系列的第二个维护更新。该版本包含了18项修复,重点解决了多进程、数据类及正则表达式等模块的回归问题,并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式(移除GIL)正式获得官方支持,是Python发展的重要里程碑。

下载
  • 本地用了 ngrok 或 Charles 这类代理工具,它们可能自动解压再转发,导致你收不到 Content-Encoding: gzip
  • Nginx 反向代理层已开启 gzip on,而 Flask/Django 的压缩被绕过——此时看 Nginx 日志比看 Python 日志更有效
  • gunicorn 启动加了 --preload,导致中间件加载顺序异常,Content-Encoding 被后续中间件覆盖

手动压缩响应体时,mtime=0 这个参数不能省

gzip.GzipFile 手动压缩时,如果不设 mtime=0,生成的 .gz 文件会带当前时间戳,导致每次压缩结果不同——这会让 CDN 或代理层无法正确缓存,也影响 ETag 计算。

正确写法:

import gzip
from io import BytesIO

buf = BytesIO()
with gzip.GzipFile(fileobj=buf, mode="wb", mtime=0) as f:
    f.write(data.encode("utf-8"))
compressed = buf.getvalue()

注意:别用 gzip.compress() 直接压字符串,它内部默认用 mtime=time.time(),缓存友好性差。

实际部署时,压缩本身几乎没成本,但头字段错一个、MIME 类型漏一项、代理层叠一层,就足以让整个压缩链路失效。重点不在“会不会压”,而在“压完能不能被客户端正确识别并解压”。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1105

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

2072

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1185

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

8844

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1479

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

1552

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

881

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

531

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1111

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PyCharm官方快速入门指南
PyCharm官方快速入门指南

共0课时 | 0人学习

Python函数定义官方教程
Python函数定义官方教程

共0课时 | 0人学习

Python 3.14.6官方文档
Python 3.14.6官方文档

共0课时 | 0人学习