Python FastAPI 快速入门与核心实战

这是 FastAPI 的一大亮点。无需编写任何文档代码，访问 /docs 即可查看生成的 Swagger UI 界面。

你可以直接在网页上点击 Try it out，填写参数并执行测试，极大简化了调试流程。

四、接收数据的方式

后端主要工作是接收前端数据、处理并返回结果。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 会自动将路径中的值转换为整数。如果传入非整数，会直接报错提示类型不匹配。

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 定义数据结构更为规范。

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)

在 /docs 页面找到 /register 接口，点击 Try it out 修改 Request body 中的 JSON 数据即可测试。FastAPI 会自动解析 JSON 并校验数据格式。

六、总结

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

• 安装：pip install fastapi
• 启动：使用 uvicorn 作为引擎
• 文档：/docs 自动生成，方便测试
• 参数：利用类型提示约束输入
• 模型：使用 BaseModel 处理复杂 POST 数据

FastAPI 不仅提升了开发效率，也帮助写出更规范的代码。