FastAPI 是一个现代、快速（高性能）的 Web 框架，用于基于 Python 构建 API 服务。

它以异步（async/await）机制为核心，兼顾开发效率与运行性能，能够自动生成交互式 API 文档，并原生支持 Pydantic 数据验证与类型提示。

FastAPI 被广泛用于数据服务、AI 模型部署、微服务架构以及前后端分离项目中，是现代 Python Web 开发的首选之一。

安装：

pip install fastapi
1.
常见应用场景：

（1）快速构建 RESTful API 服务

以最简洁的语法定义路由与接口。www.mw35.com.cn

（2）异步并发处理

基于 Starlette 与 Uvicorn 的异步机制，可高效处理高并发请求。

（3）数据验证与自动文档生成

内置与 pydantic 的集成，自动解析、验证请求参数。

自动生成 /docs（Swagger UI）与 /redoc（ReDoc）文档。

（4）AI 与数据科学服务封装

常用于封装机器学习模型或深度学习推理接口。

（5）微服务与容器化部署

与 Docker、Kubernetes 等容器技术完美兼容。

◆  ◆  ◆

核心概念

1、FastAPI 应用对象（FastAPI instance）

所有接口的注册、配置均通过 FastAPI() 实例完成。

2、路由与请求方法（Routes & Methods）

使用装饰器定义接口，如 @app.get()、@app.post()、@app.put() 等。

3、请求与响应模型（Request & Response Models）

使用 Pydantic 模型定义数据结构与验证规则。

4、异步处理（Async Support）

原生支持 async def，可并发执行 I/O 密集型操作。

5、自动文档生成（Interactive Docs）

启动服务后访问 /docs（Swagger UI） 或 /redoc（ReDoc） 查看交互式文档。

6、依赖注入系统（Dependency Injection）

提供强大的依赖管理机制，可优雅地管理数据库连接、配置或验证逻辑。

◆  ◆  ◆

应用举例

例 1：最小可运行应用

# main.pyfrom fastapi import FastAPI
app = FastAPI()
@app.get("/")def read_root():    return {"message": "Hello, FastAPI!"}
# 运行：uvicorn main:app --reload
1.
2.
3.
4.
访问 http://127.0.0.1:8000 可查看结果。

访问 http://127.0.0.1:8000/docs 查看自动生成的 Swagger 文档。

例 2：路径参数与查询参数

from fastapi import FastAPI
app = FastAPI()
@app.get("/items/{item_id}")def read_item(item_id: int, q: str = None):    return {"item_id": item_id, "query": q}
1.
2.
3.
访问 /items/42?q=apple 会返回：

{"item_id": 42, "query": "apple"}
1.
例 3：请求体与 Pydantic 模型

from fastapi import FastAPIfrom pydantic import BaseModel
app = FastAPI()
class User(BaseModel):    name: str    age: int
@app.post("/users/")def create_user(user: User):    return {"message": f"User {user.name} created.", "age": user.age}
1.
2.
3.
4.
FastAPI 会自动验证数据类型，www.yutaifu.com.cn若输入错误会返回标准化的错误响应。

例 4：异步接口（Async）

import asynciofrom fastapi import FastAPI
app = FastAPI()
@app.get("/wait/")async def wait_example():    await asyncio.sleep(2)    return {"status": "done"}
1.
2.
3.
异步接口在高并发场景下性能表现显著优于传统同步方式。

例 5：依赖注入与数据库示例

from fastapi import Depends, FastAPI
app = FastAPI()
def get_token():    return "SECRET-TOKEN"
@app.get("/secure-data/")def secure_data(token: str = Depends(get_token)):    return {"token_used": token, "data": "private content"}
1.
2.
3.
4.
通过 Depends() 注入依赖逻辑，简化权限验证、配置加载等通用操作。

◆  ◆  ◆

常用函数与类速览

FastAPI()

创建应用实例。

参数：

title：API 文档标题（默认：FastAPI）。

description：接口说明文字。

version：版本号。

返回：FastAPI 应用对象。

@app.get(path)

注册 GET 请求路由。

参数：

path：URL 路径字符串。

返回：装饰函数（注册后的视图函数）。

@app.post(path)

注册 POST 请求路由。

参数：

path：URL 路径字符串。

返回：装饰函数www.my-china.com.cn（注册后的视图函数）。

pydantic.BaseModel

定义请求或响应的数据模型。

参数：字段名与类型定义（如 name: str）。

返回：可验证数据对象。

fastapi.Depends(callable)

声明依赖项。

参数：

callable：被依赖的函数或生成器。

返回：依赖结果（自动注入）。

uvicorn.run(app, host="127.0.0.1", port=8000)

运行 FastAPI 应用。

参数：

app：应用对象或模块路径（如 "main:app"）。

host：主机地址。

port：端口号。

返回：无（启动 ASGI 服务器）。

◆  ◆  ◆

补充说明

1、FastAPI 底层基于 Starlette（异步框架）与 Pydantic（数据验证），性能接近 Go、Node.js 级别。

2、自动生成的交互式文档极大提升了前后端协作效率。

3、支持 OAuth2、JWT、CORS、WebSocket、后台任务等高级特性。

4、推荐搭配 Uvicorn 或 Gunicorn + Uvicorn workers 部署生产环境。

📘 小结

FastAPI 是 Python 的极速 API 框架，用最少代码构建最强大的服务。

FastAPI 代表了 Python Web 开发的现代范式：

🔹类型提示驱动开发（Type Hint Driven）

🔹异步高性能（Async First）

🔹自动文档生成（Interactive API Docs）