Python FastAPI 快速入门与实战基础

三、接收数据的方式

后端开发的核心流程是：接收前端数据 -> 处理 -> 返回结果。FastAPI 主要通过两种方式接收数据。

1. 路径参数 (Path Parameters)

场景：查询特定 ID 的资源，如 /student/5。

from fastapi import FastAPI
import uvicorn

app = FastAPI()

@app.get("/student/{student_id}")
def get_student(student_id: int):
    # student_id 会被自动转换为整数
    return {
        "学生 ID": student_id,
        "类型": str(type(student_id))
    }

if __name__ == "__main__":
    uvicorn.run(app="main:app", host="127.0.0.1", port=8088)

注意：函数参数中定义了 student_id: int。如果访问 /student/abc，FastAPI 会直接报错，提示类型不匹配。这种静态类型检查能显著减少运行时错误。

2. 查询参数 (Query Parameters)

场景：类似搜索功能，如 /search?keyword=python&page=1。

在 FastAPI 中，未出现在路径花括号 {} 中的参数默认为查询参数。

from fastapi import FastAPI
import uvicorn

app = FastAPI()

@app.get("/search")
def search_data(keyword: str, page: int = 1):
    # page=1 为默认值
    return {
        "关键词": keyword,
        "页码": page
    }

if __name__ == "__main__":
    uvicorn.run(app="main:app", host="127.0.0.1", port=8088)

访问 /search?keyword=apple 时，page 将使用默认值 1。

四、Pydantic 数据模型

当需要接收复杂结构的数据（如注册信息）时，逐个定义函数参数会很混乱。FastAPI 集成了 Pydantic 库来处理数据验证。

from fastapi import FastAPI
import uvicorn
from pydantic import BaseModel

app = FastAPI()

# 定义数据模型
class UserInfo(BaseModel):
    username: str
    password: str
    age: int = 18
    is_student: bool = True

@app.post("/register")
def register(user: UserInfo):
    # FastAPI 会自动解析 JSON 并校验格式
    if user.age < 18:
        return {"message": "未成年人禁止注册", "code": 400}
    return {
        "message": "注册成功",
        "用户": user.username,
        "身份": "学生" if user.is_student else "社会人"
    }

if __name__ == "__main__":
    uvicorn.run(app="main:app", host="127.0.0.1", port=8088)

测试方法：打开 /docs 页面，找到 /register 接口，点击 Try it out，在 Request body 中输入 JSON 数据即可。

五、总结

掌握以上内容，你已经具备了 FastAPI 的基础开发能力：

1. 安装：pip install fastapi 及 uvicorn。
2. 启动：理解 ASGI 服务器的作用。
3. 文档：利用 /docs 进行自动化测试。
4. 参数：通过类型提示约束路径和查询参数。
5. 模型：使用 BaseModel 处理复杂的 POST 请求体。

FastAPI 不仅提升了开发效率，其内置的类型检查和自动文档机制也保证了代码的健壮性。