FastAPI
构建、调试和强化FastAPI服务的专用技能
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：FastAPI。 它的用途是：构建、调试和强化FastAPI服务的专用技能 完整的 Skill 内容见：https://321skill.com/skills/fastapi-x-8/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我FastAPI应用所有路由都变慢了，怀疑是同步数据库驱动阻塞了事件循环，请帮我审查代码并修复。' 它会扫描代码中的同步IO调用，推荐替换为异步驱动（如asyncpg、aiomysql），并调整依赖注入中yeild清理逻辑，同时给出性能测试建议。
介绍
解决FastAPI开发中从异步端点、Pydantic模型到部署的全链路问题，包括事件循环阻塞、422/307/500错误、CORS缺失、pydantic v1→v2迁移、Depends执行异常、SQLAlchemy连接池泄漏、TestClient事件循环关闭、uvicorn/gunicorn配置错误、WebSocket/SSE/上传/OpenAPI文档异常等。当您编写或审查FastAPI应用、路由、Schema时，或遇到API挂起、请求返回意外状态码、依赖注入未按预期工作、部署配置犹豫不决时，可立即调用此技能获得精准诊断和修复建议。适合后端开发、全栈开发、运维工程师，他们需要快速定位FastAPI特有陷阱并给出生产级方案。注意本技能专为FastAPI设计，不适用于Django、Flask或通用Python项目，也不覆盖非Python后端场景。
核心特点
覆盖FastAPI从开发到部署的全链路痛点，尤其聚焦事件循环阻塞、pydantic迁移、依赖注入优化、异步驱动兼容等实战陷阱，比官方文档更贴近高频调试场景。
注意事项
不适用于Django、Flask或通用Python项目，也不处理非Python后端框架问题。
常见问题
为什么我的POST请求返回307？
可能是路由配置导致重定向，检查@router.post是否拼写正确，或中间件设置了Location头。
如何迁移pydantic v1到v2？
使用model_dump替代dict，from_attributes替代orm_mode，field_validator替代validator，并注意配置变更。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/fastapi-x-8/raw/index.md 读取 FastAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/fastapi-x-8/raw/index.md（查看排版版本）