FastAPI路由与请求处理全解：手把手打造用户管理系统-牛翰网

title: FastAPI路由与请求处理全解：手把手打造用户管理系统
date: 2025/3/2
updated: 2025/3/2
author: cmdragon

excerpt:
通过咖啡店点单系统的生动案例，零基础掌握FastAPI路由核心机制。你将：
用真实场景理解@app.get/@app.post等6种HTTP方法装饰器
通过用户管理API实现完整CRUD操作
学习路径参数与查询参数的进阶玩法
获得防误操作锦囊（含参数校验/SQL注入防御方案）

categories:

后端开发
FastAPI

tags:

FastAPI路由实战
HTTP方法详解
路径参数技巧
查询参数进阶
用户管理API
请求处理陷阱
新手友好教程

图片[1]-FastAPI路由与请求处理全解：手把手打造用户管理系统-牛翰网

扫描二维码关注或者微信搜一搜：编程智域前端至全栈交流与成长

探索数千个预构建的 AI 应用，开启你的下一个伟大创意

通过咖啡店点单系统的生动案例，零基础掌握FastAPI路由核心机制。你将：

用真实场景理解@app.get/@app.post等6种HTTP方法装饰器
通过用户管理API实现完整CRUD操作
学习路径参数与查询参数的进阶玩法
获得防误操作锦囊（含参数校验/SQL注入防御方案）

第一章：路由就像咖啡店电话转接

1.1 基础路由结构

from fastapi import FastAPI

app = FastAPI()


# 简单GET路由
@app.get("/menu")
async def get_menu():
    return {"饮品": ["美式", "拿铁", "卡布奇诺"]}


# 带路径参数的GET路由
@app.get("/orders/{order_id}")
async def get_order(order_id: int):
    return {"订单号": order_id, "状态": "制作中"}

1.2 HTTP方法对照表

方法	咖啡店比喻	FastAPI装饰器
GET	查看菜单	`@app.get`
POST	下单新订单	`@app.post`
PUT	修改订单	`@app.put`
DELETE	取消订单	`app.delete`

第二章：用户管理API实战

2.1 完整CRUD实现

from typing import List
from pydantic import BaseModel


class User(BaseModel):
    id: int
    name: str
    email: str


fake_db: List[User] = []


# 创建用户
@app.post("/users")
async def create_user(user: User):
    fake_db.append(user)
    return {"操作": "创建成功", "数据": user}


# 获取所有用户
@app.get("/users")
async def get_users():
    return fake_db


# 更新用户
@app.put("/users/{user_id}")
async def update_user(user_id: int, new_user: User):
    for index, user in enumerate(fake_db):
        if user.id == user_id:
            fake_db[index] = new_user
            return {"操作": "更新成功"}
    return {"错误": "用户不存在"}


# 删除用户
@app.delete("/users/{user_id}")
async def delete_user(user_id: int):
    global fake_db
    fake_db = [user for user in fake_db if user.id != user_id]
    return {"操作": "删除成功"}

2.2 Swagger UI自动文档
访问 http://localhost:8000/docs 查看效果：

第三章：参数处理黑科技

3.1 路径参数 vs 查询参数

# 路径参数
@app.get("/products/{category}")
async def get_by_category(category: str):
    ...


# 查询参数
@app.get("/search")
async def search_products(keyword: str, limit: int = 10):
    ...

3.2 参数校验技巧

from fastapi import Query


@app.get("/users")
async def filter_users(
        age: int = Query(..., ge=18, description="最小年龄"),
        is_vip: bool = Query(False)
):
    return [u for u in fake_db if u.age >= age and u.is_vip == is_vip]

第四章：课后安全实验室

任务1：修复SQL注入漏洞

# 危险代码
@app.get("/user/{name}")
async def get_user(name: str):
    query = f"SELECT * FROM users WHERE name = '{name}'"

# 你的任务：使用参数化查询改写

任务2：添加分页功能

@app.get("/users")
async def get_users(
        page: int = Query(1, ge=1),
        size: int = Query(10, le=100)
):
    # 实现分页逻辑
    start = (page - 1) * size
    return fake_db[start:start + size]

常见错误诊疗室

错误现象	原因	解决方案
`422 Validation Error`	参数类型不匹配	检查路径参数是否为int/查询参数是否必填
`405 Method Not Allowed`	使用错误的HTTP方法	确认路由装饰器与方法匹配
`路由冲突`	多个路由相同路径	确保路径+方法组合唯一