FastAPI
专为FastAPI应用开发与调试设计的AI助手技能，覆盖构建、排错与部署全流程。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：FastAPI。 它的用途是：专为FastAPI应用开发与调试设计的AI助手技能，覆盖构建、排错与部署全流程。 完整的 Skill 内容见：https://321skill.com/skills/fastapi-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我的FastAPI应用在部署后，某个POST接口偶尔会返回307状态码，而不是200，这是什么原因？’ 它会引导你检查路由定义、中间件配置、代理服务器设置（如Nginx的`proxy_redirect`）以及是否可能存在尾随斜杠的重定向问题。或者，你可以说：‘我在使用`Depends`时，感觉某个数据库依赖函数被调用了太多次，如何优化？’ 它会分析你的依赖树，建议使用`lru_cache`或调整依赖项的生命周期来避免重复计算。
介绍
本Skill旨在解决FastAPI服务开发、调试与加固过程中的各类复杂问题。当您编写或审查FastAPI应用、路由或Pydantic模型时，它可以提供实时指导；当API因同步驱动或CPU密集型任务阻塞事件循环而挂起或变慢时，它能帮助定位瓶颈；当请求返回意外的422错误、POST请求变为307重定向，或500错误缺少CORS头时，它能协助排查原因。
它通过分析您的代码上下文和问题描述，提供具体的解决方案、代码片段和最佳实践建议。您可以在遇到依赖注入（Depends）运行过于频繁、yield清理未触发、SQLAlchemy连接池问题、异步客户端测试失败、部署配置决策等场景时使用它。
本Skill特别适合正在使用FastAPI框架进行后端服务开发的工程师，无论是处理日常开发任务、进行代码审查，还是紧急排查线上故障，都能从中获得针对性帮助。
建议在描述问题时尽可能提供详细的错误信息、相关代码片段和运行环境，以便获得更精准的解答。请注意，它专注于FastAPI生态，不适用于Django、Flask或通用Python问题。
核心特点
与通用Python或Web开发技能不同，本Skill深度聚焦于FastAPI框架特有的问题域，如异步事件循环阻塞、Pydantic V1/V2迁移、FastAPI依赖注入系统的疑难杂症（如`Depends`、`yield`）、以及与Uvicorn/Gunicorn/异步测试客户端（TestClient, httpx）集成的部署和调试问题，提供了高度垂直和具体的解决方案。
注意事项
不适用于Django、Flask框架或通用Python编程问题，仅针对FastAPI及相关生态（如Pydantic, SQLAlchemy async, Uvicorn）的场景。
常见问题
如何解决FastAPI中SQLAlchemy的`QueuePool limit`错误？
检查数据库连接是否在请求结束后正确关闭，确保在依赖项中使用`yield`或在事件中正确处置会话，并考虑调整连接池大小和回收策略。
从Pydantic v1迁移到v2，`model_dump`和`field_validator`怎么用？
v2中，`dict()`方法替换为`model_dump()`，`validator`装饰器替换为`@field_validator`，且验证器函数签名有所变化，需要相应调整。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/fastapi-x-3/raw/index.md 读取 FastAPI 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/fastapi-x-3/raw/index.md（查看排版版本）