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
请求处理陷阱
新手友好教程

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

探索数千个预构建的 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方法	确认路由装饰器与方法匹配
`路由冲突`	多个路由相同路径	确保路径+方法组合唯一

结语

现在运行 uvicorn main:app --reload 启动你的用户管理API吧！遇到问题随时查阅附带的路由调试检查清单，编码愉快！

余下文章内容请点击跳转至个人博客页面或者扫码关注或者微信搜一搜：编程智域前端至全栈交流与成长，阅读完整的文章：FastAPI路由与请求处理全解：手把手打造用户管理系统 | cmdragon's Blog

往期文章归档：