FastAPI
构建、调试和加固FastAPI服务的专家级Skill
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：FastAPI。 它的用途是：构建、调试和加固FastAPI服务的专家级Skill 完整的 Skill 内容见：https://321skill.com/skills/fastapi-x-9/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我的FastAPI POST接口返回422，但请求体看起来没问题，帮我检查一下Pydantic模型和路由定义。' 它会立即分析请求体样例、模型定义、路由装饰器，定位到字段类型不匹配或缺少必填字段，并给出修正后的代码。
介绍
本Skill专门解决FastAPI开发中的常见疑难杂症：当API挂起或所有路由变慢，因为同步驱动或CPU工作阻塞了事件循环；当请求返回意外的422、POST变成307、或500无CORS头；当从Pydantic v1迁移到v2遇到model_dump、from_attributes、field_validator问题；当Depends运行过于频繁、yield清理不生效、依赖覆盖不生效；当SQLAlchemy抛出QueuePool limit或MissingGreenlet，或连接泄露；当TestClient、httpx AsyncClient、pytest-asyncio因事件循环关闭而失败；当uvicorn或gunicorn工作进程、优雅关闭、root_path、代理头需要决策；或当后台任务、WebSocket、SSE、上传、OpenAPI文档行为异常。
使用方式：将本Skill添加到AI编码代理（如Claude、Cursor、Trae）的配置中，然后在编写或审查FastAPI应用、路由、模式时，直接描述问题或需求，AI会基于本Skill的深度知识进行分析、调试、修复和加固。
适合用户：FastAPI后端开发者、全栈工程师、需要维护现有FastAPI服务的运维工程师，以及从Pydantic v1迁移到v2、或从Flask/Django转向FastAPI的开发者。
注意事项：本Skill专注于FastAPI生态，不适用于Django、Flask、普通Python脚本。建议在遇到具体问题时（如422错误、事件循环阻塞、依赖注入异常）优先使用，以获取针对性的诊断和修复方案。
核心特点
本Skill不仅覆盖FastAPI基本用法，更深入挖掘了事件循环阻塞、Pydantic版本迁移、SQLAlchemy异步session、依赖注入缓存、部署配置等高频痛点，提供了比通用FastAPI文档更具体、更可操作的调试和加固策略。
注意事项
不适用于Django、Flask或普通Python开发，也不处理与FastAPI无关的通用Python问题。
常见问题
如何调试FastAPI接口返回422 Unprocessable Entity？
检查请求体是否符合Pydantic模型的字段定义，包括类型、必填、验证器；使用`request.json()`打印原始JSON；查看`request.headers`的Content-Type是否为`application/json`。
如何解决SQLAlchemy的MissingGreenlet错误？
确保在异步路由中使用`async with`或`await`方式获取session，并配置`AsyncSession`，避免在同步上下文中使用异步session。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/fastapi-x-9/raw/index.md 读取 FastAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/fastapi-x-9/raw/index.md（查看排版版本）