FastAPI
FastAPI全生命周期开发与调试工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：FastAPI。 它的用途是：FastAPI全生命周期开发与调试工具 完整的 Skill 内容见：https://321skill.com/skills/fastapi-x-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我调试这个FastAPI路由，当请求返回422时，检查Pydantic模型定义是否正确，并给出修复建议。' 它会分析你的模型和路由，定位字段校验错误，输出修正后的代码。或者：'我的TestClient报错Event loop is closed，帮我排查并修正测试代码。' 它会检查pytest-asyncio配置和async测试模式，给出正确的fixture和测试函数写法。
介绍
解决FastAPI开发中从编码到部署的各类棘手问题：异步端点阻塞、Pydantic v1/v2迁移、依赖注入异常、SQLAlchemy连接池泄漏、测试客户端事件循环关闭、uvicorn/gunicorn配置不当等。覆盖请求校验422错误、CORS缺失、后台任务、WebSocket、SSE、上传等场景。
使用方式：在编写或审查FastAPI应用、路由、Schema时，直接描述遇到的问题，Skill会分析代码上下文，定位根因并给出修复建议。例如：对TestClient报错’closed event loop’，它会检查pytest-asyncio配置和异步测试模式；对Depends运行过频，它会建议缓存或重构依赖链。
适合人群：后端开发、全栈开发、运维工程师，以及需要快速排查FastAPI生产环境问题的团队。尤其适合从Pydantic v1迁移到v2的开发者，或遇到异步/同步混用导致性能瓶颈的工程师。
使用建议：建议在清晰的代码语境下使用，避免整体项目重构。由于Skill专注于FastAPI，请勿用于Django、Flask或通用Python任务。对于复杂的ORM查询优化或数据库设计，需结合SQLAlchemy专业知识。
核心特点
同类FastAPI工具通常只生成代码模板，而本Skill覆盖了从Pydantic迁移、依赖注入调试、异步事件循环分析到部署配置的全链路调试，并预设了常见坑位的排查逻辑（如422、307、500错误、CORS头缺失、TestClient事件循环关闭等）。
注意事项
不适用于Django、Flask或通用Python开发，且对非FastAPI特有的业务逻辑（如复杂算法实现）支持有限。
常见问题
如何将Pydantic v1模型迁移到v2？
使用model_dump()替代dict()，from_attributes替代orm_mode，field_validator替代validator，并注意配置类写法变化。
TestClient报错'Event loop is closed'怎么办？
确保测试函数使用async def并配合pytest-asyncio，或在测试模块中添加@pytest.fixture(scope='session')管理事件循环。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/fastapi-x-5/raw/index.md 读取 FastAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/fastapi-x-5/raw/index.md（查看排版版本）