Django Bolt 是结合 Django ORM 与生态、并借助 Rust(Hyper、Tokio)和 msgspec 提升性能的框架。
用途:构建高性能 API,同时沿用 Django 的 ORM 与项目结构。
主要能力:异步 ORM(aget、alist、acreate 等);内置 JWT 认证与刷新令牌轮换;WebSocket(无需 channels);SSE 流式传输;文件上传;msgspec 序列化与请求体校验;自动生成 OpenAPI 3.1 文档(/docs、/redoc、/scalar、/rapiddoc);ViewSet 与 ModelViewSet;中间件、依赖注入、限流等。
安装与用法:pip install django-bolt,将 "django_bolt" 加入 INSTALLED_APPS;用 BoltAPI 定义路由(@api.get 等),在 urls.py 中挂载 api.urls;开发用 python manage.py runbolt --dev,生产用 python manage.py runbolt 并可通过 --host、--port、--processes、--max-rss、--workers-lifetime、--respawn-failed-workers、--backlog、--keep-alive 等参数配置。测试可用 django_bolt.test.AsyncAPITestClient。配置项包括 BOLT、JWT_*、BOLT_MAX_UPLOAD_SIZE、BOLT_CORS、BOLT_TRUSTED_PROXIES 等。
适用场景:需要高吞吐的 Django API 服务、实时通信、JWT 鉴权接口,以及从 DRF 迁移的项目。
限制:v0.4.0 起要求 Python 3.12+;v0.6.0 移除 SessionAuthentication;v0.10.0 Cookie-JWT CSRF 检查默认开启;v0.10.3 反向代理后必须配置 BOLT_TRUSTED_PROXIES;v0.11.0 移除 Nested(),改用普通类型注解。性能数据基于特定硬件与负载条件,实际结果受环境与数据库影响。部分高级主题(部署、MCP、DRF 迁移等)仅以参考文件形式提及,本资料未展开具体细节。