资源描述
Litestar 是一个高性能、生产就绪的异步 Python Web 框架，专为构建低延迟 API、LLM 服务与实时流式响应（如 Server-Sent Events、WebSocket 流）而设计。相比 FastAPI 内存占用降低约 40%，原生支持 OpenAPI 3.1、依赖注入、缓存中间件、数据验证（Pydantic v2）、插件生态及异步生命周期管理，适用于微服务、AI 接口网关与高并发后端场景。
详细内容
# Litestar：高性能异步 Python Web 框架
## 框架简介与定位
Litestar 是一个轻量、模块化、类型安全的 ASGI Web 框架，基于 Starlette 和 Pydantic 构建，但重构了核心执行模型以实现更优性能与可扩展性。它不追求向后兼容 FastAPI 的 API 表面，而是聚焦于现代异步 Python 生态（Python ≥ 3.9）下的工程实践——强调显式性、可测试性、可维护性与资源效率。其设计哲学是「约定优于配置，但绝不隐藏关键路径」，适合构建云原生 API、LLM 前端代理、实时数据服务及微服务边界层。
## 核心特性
- **极致异步原生支持**：全栈 `async`/`await` 设计，路由处理、中间件、钩子（hooks）、插件均支持协程，无同步阻塞路径
- **OpenAPI 3.1 原生生成**：自动推导路由、参数、响应模型与错误状态，支持 `@get(..., openapi_include=False)` 等细粒度控制
- **声明式依赖注入系统**：支持作用域（`app`/`request`/`state`/`socket`）、懒加载、类型注解驱动注入，无需装饰器污染业务逻辑
- **内置流式响应能力**：对 `StreamingResponse`、`ServerSentEvents`、`WebSocket` 提供统一抽象与生命周期钩子（`on_ws_connect`, `on_ws_disconnect`）
- **轻量可靠中间件栈**：含 `RateLimitingMiddleware`、`CompressionMiddleware`、`CachingMiddleware`（支持 Redis/Memory 后端），内存占用约为 FastAPI 的 60%
- **开箱即用的数据验证与序列化**：深度集成 Pydantic v2，支持 `@post(..., dto=...)` 定义输入/输出 DTO，自动转换与校验
## 适用场景
- LLM 推理服务网关（支持 token 流式返回、请求限流、上下文缓存）
- 实时协作应用后端（如文档协同、游戏状态同步）
- 高吞吐 API 网关或微服务入口（需低延迟、可控内存、可观测性）
- 需要严格 OpenAPI 规范交付的 BFF（Backend for Frontend）层
- 对启动时间与内存 footprint 敏感的 Serverless 或边缘部署场景
## 快速入门步骤
1. **安装**（推荐使用 Poetry 或 pip）：
```bash
pip install litestar
# 或启用常用插件
pip install litestar[redis,sqlalchemy,openapi]
```
2. **最小示例**（保存为 `app.py`）：
```python
from litestar import Litestar, get
from litestar.response import Stream
import asyncio
@get("/stream")
async def stream_data() -> Stream:
async def data_generator():
for i in range(5):
yield f"event: {i}\ndata: hello\n\n"
await asyncio.sleep(0.5)
return Stream(data_generator())
app = Litestar(route_handlers=[stream_data])
```
3. **运行**：
```bash
litestar run --host 0.0.0.0 --port 8000
# 访问 http://localhost:8000/stream 查看 SSE 流
```
## 生态与社区
Litestar 拥有活跃的开源社区（GitHub 主仓库 stars > 4.5k，月活跃贡献者 ≥ 15），官方维护 [litestar-org](https://github.com/litestar-org) 组织下涵盖 SQLAlchemy、Redis、SQLModel、JWT、Prometheus 等插件。文档详实（含 API 参考、概念指南、迁移指南），CLI 工具 `litestar` 支持项目生成、代码格式化与热重载。社区提供 Discord 支持频道与每周 Office Hours，同时被多个 AI 基础设施项目（如 LangChain + Litestar 示例模板、LlamaIndex 官方适配）采纳为推荐后端框架。