starlette 本身不直接提供 gzip 压缩中间件,但可以通过引入第三方库 starlette-compress 或在项目中集成 brotli 和 zlib 来实现。最推荐的做法是使用 starlette.middleware.gzip.gzipmiddleware(如果存在)或自定义中间件,或者使用像 fastapi.middleware.gzip 这样的兼容方案。实际上,starlette 官方并未内置 gzip 中间件,通常建议结合 uvicorn 或 gunicorn 的 worker 配置,或者使用 starlette-compress 包。这里我们演示如何使用 starlette-compress 库来添加 gzip 支持,这是目前社区中较为通用的做法。

如何安装并配置 starlette-compress 中间件
要启用 Gzip 压缩,首先需要安装 starlette-compress 库。安装后,将其添加到 Starlette 应用的中间件列表中。该中间件会自动检查客户端的 Accept-Encoding 头,如果包含 gzip,则对响应体进行压缩。默认情况下,它会对文本类型的内容进行压缩,跳过二进制文件和小文件。

GzipMiddleware 如何处理 Accept-Encoding 头
当请求到达时,GZipMiddleware 会解析 Accept-Encoding 头。如果客户端支持 gzip,中间件会将响应体的编码方式更改为 gzip,并设置 Content-Encoding: gzip 头。同时,它会更新 Content-Length 为压缩后的长度。如果客户端不支持 gzip,则按原样返回响应。这个过程是透明的,开发者无需修改业务逻辑代码。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

在路由处理函数中验证压缩效果
为了验证 Gzip 压缩是否生效,可以创建一个简单的路由,返回较大的 JSON 数据。通过浏览器开发者工具或 curl 命令检查响应头中的 Content-Encoding 字段。如果看到 gzip,说明压缩成功。此外,还可以比较压缩前后的响应大小,以评估压缩率。对于小文件或二进制数据,压缩可能不会生效,这是正常行为。
from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import json
def home(request):
data = {"message": "Hello, World!" * 100} # 生成较大数据
return JSONResponse(data)
routes = [
Route("/", home),
]
app = Starlette(routes=routes)
预期结果:访问 / 端点,响应头中包含 Content-Encoding: gzip,且响应体大小为压缩后的字节数。










