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):
    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，FastAPI 会自动将路径中的字符串转换为整数。如果传入非整数（如 /student/abc），框架会直接报错。

2. 查询参数 (Query Parameters)

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

from fastapi import FastAPI
import uvicorn

app = FastAPI()

@app.get("/search")
def search_data(keyword: str, page: int = 1):
    return {
        "你搜的词": keyword,
        "当前页码": page
    }

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

未出现在路径中的函数参数默认为查询参数。page=1 表示该参数有默认值。

五、Pydantic 数据模型

当接口需要接收复杂数据（如注册信息）时，建议使用 Pydantic 的 BaseModel 定义数据结构。

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):
    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)

通过指定参数类型为 UserInfo，FastAPI 会自动解析前端传来的 JSON 数据并填充到 user 变量中，同时验证字段类型和必填项。

六、总结

本文介绍了 FastAPI 的基础用法，包括环境安装、服务启动、自动文档生成、路径与查询参数处理以及 Pydantic 数据模型的应用。掌握这些内容后，可以快速构建规范且健壮的 Python Web API。