Flask-Compress默认压缩text/html、text/css、text/xml、application/json、application/javascript等类型；不压缩text/plain、application/vnd.api+json等未显式配置的类型，且不支持带参数的MIME类型或通配符匹配。
Flask-Compress 能自动对响应体做 Gzip 压缩，但默认不压缩 text/html 以外的类型，且容易因响应头、缓存策略或中间件顺序出问题。
Flask-Compress 默认压缩哪些 MIME 类型？
它只压缩白名单内的类型，默认包括 text/html、text/css、text/javascript、application/json 等，但不包含 application/vnd.api+json 或自定义 text/plain; charset=utf-8 这类带参数的类型。
- 可通过
COMPRESS_MIMETYPES配置项扩展，例如：app.config['COMPRESS_MIMETYPES'] = ['text/html', 'application/json', 'application/vnd.api+json']
- 注意：MIME 类型匹配是前缀匹配，
text/*可匹配text/plain，但 Flask-Compress 默认不启用通配符匹配，需手动添加具体类型 - 若返回的是
text/plain且未在列表中，压缩会被跳过，浏览器收到的仍是明文
为什么设置了 COMPRESS_LEVEL 却没生效？
COMPRESS_LEVEL 控制 zlib 压缩级别（0–9），但仅当响应体长度 ≥ COMPRESS_MIN_SIZE（默认 500 字节）时才触发压缩；小响应直接绕过。
提示词大师-python版
下载
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 调试时可用
curl -H "Accept-Encoding: gzip" -I http://localhost:5000/api查看响应头是否含Content-Encoding: gzip - 若没出现，先检查响应体大小：用
print(len(response.get_data()))确认是否低于COMPRESS_MIN_SIZE - 临时调低阈值：设置
app.config['COMPRESS_MIN_SIZE'] = 1（仅调试用，上线应恢复） -
COMPRESS_LEVEL=9并不总比6更好——CPU 开销上升，压缩率提升有限，生产环境推荐用默认值6
和 Flask-Caching 或 Nginx 共存时的常见冲突
Flask-Compress 依赖修改 response.headers 和 response.response 迭代器，若其他中间件（如缓存装饰器）提前消费了响应体或设置了 Vary: Accept-Encoding 不一致，会导致压缩失效或 500 错误。
立即学习“Python免费学习笔记（深入）”；
- 确保
Compress(app)在所有可能包装响应的扩展之后初始化（比如在Cache初始化之后） - 若用了 Nginx，建议关掉 Flask-Compress，改由 Nginx 处理压缩（更高效），此时需确保 Nginx 配置含：
gzip on;<br>gzip_types application/json text/css text/javascript;
- 手动设置
Vary头不是必须的——Flask-Compress 默认会加Vary: Accept-Encoding，重复设置可能引发警告
最常被忽略的是：Flask-Compress 不处理流式响应（yield 生成器）、不压缩重定向响应（302）、也不压缩已带 Content-Encoding 头的响应。如果接口返回大 JSON 但没压缩，优先查 MIME 类型是否在白名单里，而不是怀疑配置没加载。
