用途:面向 Python Web 与 API 开发,提供一套分层与建模规范,帮助把路由、领域逻辑和数据访问分开,并统一请求/响应模型与认证处理方式。
主要能力与要求:路由处理器只做校验、委派和响应映射,不写业务逻辑;框架对象(Request、Response、ORM 模型)不得进入领域层;所有请求模型设置 model_config = {"strict": True};每个端点分别定义请求与响应模型,不复用 ORM 模型作为 API schema;认证在边缘解析,领域函数接收已类型化的身份而非原始 token;领域异常在边界映射为 HTTP 状态码;异步处理器使用 httpx.AsyncClient,不用 requests;后台任务不持有请求作用域对象引用。
使用方式:资料建议加载 standards-for-python-development 获取共享规则,加载 python3-typing 做请求/响应建模,加载 python3-testing 编写端点与认证测试。
同步与异步取舍:CPU 密集用同步加线程池;多个外部 API 调用用异步加 httpx.AsyncClient;简单 CRUD 配同步 ORM 用同步处理器;WebSocket 必须异步。
常见陷阱:FastAPI 依赖按图解析而非定义顺序,需要顺序时显式链式声明;Pydantic v2 用 model_dump()、model_dump_json()、model_validate(),不要用 .dict()/.json();异步处理器中 import requests 会阻塞事件循环;Django 异步视图中的裸 Model.objects.get() 会阻塞,应使用 aget()(Django 4.1+)或 sync_to_async;allow_origins=["*"] 应改为枚举具体来源;请求、响应、数据库应使用三个独立模型。
限制:资料未提供安装命令、版本要求、收费或平台信息,暂未提供。