用途:该技能面向使用 FastAPI 构建 Python API 的开发者,提供经过生产验证的代码模式,覆盖项目结构、数据校验、异步数据库集成与 JWT 认证。
主要能力:包含基于领域的项目结构(按 auth、items、shared 等域组织,而非按文件类型);Pydantic v2 校验模式(Field 约束、Create/Update/Response 分离、from_attributes);SQLAlchemy 2.0 异步模型与数据库会话管理;JWT 认证(注册、登录、get_current_user 依赖、路由保护);配置管理(pydantic-settings 与 .env);CORS 中间件与 lifespan 建表。资料还列出 7 个已知问题的预防方法,如 Form 数据丢失 model_fields_set 元数据、BackgroundTasks 被自定义 Response 覆盖、可选 Form 字段与 TestClient 的回归问题。
使用方式:用 uv 初始化项目并添加依赖:uv init my-api;uv add fastapi[standard] sqlalchemy[asyncio] aiosqlite python-jose[cryptography] passlib[bcrypt];开发服务器运行 uv run fastapi dev src/main.py,文档位于 http://127.0.0.1:8000/docs。
版本与要求:FastAPI 0.128.0、Pydantic 2.11.7、SQLAlchemy 2.0.30、Uvicorn 0.35.0、python-jose 3.3.0;需 Python 3.9+(0.125.0 起不再支持 3.8),Pydantic v2.7.0+(0.128.0 起完全移除 v1 支持)。
限制:资料未提供收费、价格、平台支持范围或性能效果等信息;已知问题预防部分仅覆盖官方 GitHub 与发布说明中记录的 7 个问题,其他场景需自行验证。