本页目录

本页目录

Python API 技术栈

结论

首选——FastAPI + Pydantic + Uvicorn 是标准的 Python API 技术栈;三者应作为一个整体采用,而不是分别挑选。

适用场景

  • Python 后端已依据 Python 工具链 中的标准完成必要性论证。
  • 构建需要数据校验与结构化模型的 Python API。
  • 部署 FastAPI 应用,且部署平台未提供托管 ASGI 服务器。

不适用场景

  • 纯 TypeScript 架构已经足够——不要自动引入 Python 后端(见 Python 工具链)。
  • 部署平台为 Uvicorn 提供了合适的托管替代方案。

优势

  • FastAPI:高性能 ASGI 框架,自动生成 OpenAPI 文档。
  • Pydantic:提供带类型的数据校验和结构化模型,并与 FastAPI 的请求、响应处理集成。
  • Uvicorn:轻量、标准的 ASGI 服务器,用于运行 FastAPI 应用。

代价

  • 会多出一个需要单独管理依赖和部署的 Python 服务。
  • Pydantic 模型必须与所校验的数据保持同步。

版本策略

  • 新项目优先使用 FastAPI、Pydantic 和 Uvicorn 的最新稳定版。
  • 没有具体的兼容性理由,不要让该技术栈停留在过时版本上。

使用规则

  • 使用 FastAPI 作为 Python API 框架。
  • 在合适的情况下使用 Pydantic 完成 Python 数据校验与结构化建模。
  • FastAPI 应用默认以 Uvicorn 作为 ASGI 服务器,除非部署平台提供了合适的托管替代方案。

联动

内部联动

  • FastAPI + Pydantic——Pydantic 模型是 FastAPI 的校验层;请求和响应 schema 应定义为 Pydantic 模型,而不是手写校验逻辑。
  • FastAPI + Uvicorn——除非平台提供托管替代方案,否则 Uvicorn 是 FastAPI 应用的标准 ASGI 服务器。

相关指南

  • Python 工具链——用 uv 管理该技术栈的环境和依赖,用 ruff 执行 Lint。