5.4 依赖项缓存与生命周期

Python FastAPI入门教程：轻松理解依赖项缓存与生命周期

FastAPI 教程

本教程面向Python初学者，无Web开发经验，详细讲解FastAPI中的依赖项缓存与生命周期概念。通过生活化类比和简单代码示例，快速上手FastAPI，建立开发信心，涵盖基础安装、实践操作和成功示例。

FastAPI入门教程：依赖项缓存与生命周期详解

引言：为什么学FastAPI？

想象一下，你想开一家快餐店，需要快速制作美味食物给顾客。FastAPI就像那个高效的工具，帮助你快速搭建Web API（应用程序接口），让别人通过互联网访问你的服务。如果你是Python初学者，别担心！本教程将从零开始，用简单的生活化类比和动手实践，带你走进FastAPI的世界，重点是理解依赖项缓存与生命周期这两个核心概念。

目标读者：有Python语法基础，但没碰过Web开发的朋友。我们会一步步来，确保你有许多“成功时刻”——就是运行代码、看到结果的那一刻！

第1部分：什么是FastAPI？

FastAPI是一个现代的、快速的Python Web框架，用于构建API。它就像餐厅的厨师，能快速响应订单（HTTP请求）并送上美味的食物（数据响应）。我们学它，因为它简单、高效，而且适合Python新手入门。

类比：把FastAPI想象成一家自动化餐厅——顾客点餐（发送请求），系统自动处理（FastAPI运行），很快出餐（返回响应）。

第2部分：安装和环境设置

开始之前，确保你有Python 3.6或更高版本。打开终端或命令行，运行以下命令安装FastAPI和服务器Uvicorn（Uvicorn就像一个服务员，负责端菜给顾客）。

pip install fastapi uvicorn

成功时刻：安装完成后，输入 python -c "import fastapi; print('FastAPI安装成功！')"，看到输出就说明准备好了！

第3部分：创建第一个FastAPI应用

让我们写一个最简单的程序，体验成功。新建一个Python文件，比如 main.py，添加以下代码：

from fastapi import FastAPI

app = FastAPI()  # 创建FastAPI应用，就像开店

@app.get("/")  # 定义一个GET端点，顾客访问主页
async def read_root():
    return {"Hello": "World"}  # 返回一个JSON响应

保存文件，然后在命令行运行：

uvicorn main:app --reload

打开浏览器，访问 http://127.0.0.1:8000，你会看到 {"Hello": "World"} 显示出来！恭喜，你的第一个API运行成功了！

解释：这里，@app.get("/") 表示当有人访问根路径时，调用 read_root 函数返回数据。FastAPI自动处理HTTP细节，让新手轻松上手。

第4部分：依赖项基础——什么是依赖项？

在FastAPI中，依赖项（Dependency）就像餐厅厨师做饭时需要的食材或工具。API端点可能依赖某些数据或服务，依赖项帮助管理和共享这些资源。

生活化类比：厨师做披萨依赖面团、奶酪和酱料。同样，API端点依赖数据库连接或验证函数。

让我们添加一个依赖项示例。修改 main.py：

from fastapi import FastAPI, Depends

def get_message():
    return "Welcome to FastAPI!"  # 这是一个依赖项函数

app = FastAPI()

@app.get("/")
async def read_root(message: str = Depends(get_message)):
    return {"message": message}

运行应用，访问主页，你会看到 {"message": "Welcome to FastAPI!"}。依赖项 get_message 提供了数据给端点。

成功时刻：运行代码，看到自定义消息，你已经理解了依赖项的基本使用！

第5部分：依赖项的缓存——为什么和如何缓存？

缓存（Caching）意味着临时存储数据，避免重复计算，提高性能。在FastAPI中，依赖项可以缓存，减少每次请求的开销。

类比：厨师预先切好蔬菜，下次做菜时直接使用，节省时间。同样，API缓存依赖项结果，让响应更快。

FastAPI默认缓存依赖项，但让我们显式展示一下。更新 main.py：

from fastapi import FastAPI, Depends
from functools import lru_cache  # 导入缓存工具

# 使用lru_cache缓存依赖项
@lru_cache()
def get_cached_data():
    print("计算中...")  # 模拟耗时操作
    return {"data": "This is cached"}

app = FastAPI()

@app.get("/cached")
async def read_cached(data: dict = Depends(get_cached_data)):
    return data

运行应用，访问 http://127.0.0.1:8000/cached。第一次访问会在终端看到“计算中...”，之后多次访问不会显示，因为结果被缓存了。

解释：lru_cache 是Python内置的缓存装饰器，FastAPI的 Depends 也支持缓存机制。这优化了性能，尤其在高流量场景。

第6部分：依赖项的生命周期——创建、使用、销毁

生命周期（Lifecycle）指的是依赖项从创建到销毁的过程。在FastAPI中，依赖项可以在请求开始时创建，使用后根据需要销毁。

类比：食材有保鲜期，从采购、使用到丢弃；API依赖项也有类似的生命周期，如数据库连接需要打开和关闭。

FastAPI通过上下文管理器或异步函数支持生命周期管理。让我们看一个简单示例：

from fastapi import FastAPI, Depends
from contextlib import asynccontextmanager

# 定义一个模拟资源，有生命周期
class Resource:
    def __init__(self):
        print("资源创建")
    def use(self):
        return "资源使用中"
    def close(self):
        print("资源销毁")

# 使用上下文管理器管理生命周期
@asynccontextmanager
async def get_resource():
    resource = Resource()  # 创建资源
    try:
        yield resource  # 在请求中使用
    finally:
        resource.close()  # 请求结束后销毁

app = FastAPI()

@app.get("/resource")
async def use_resource(resource: Resource = Depends(get_resource)):
    return {"status": resource.use()}

运行应用，访问 http://127.0.0.1:8000/resource。在终端，你会看到“资源创建”和“资源销毁”打印出来，展示了生命周期的开始和结束。

成功时刻：运行代码，观察日志输出，直观理解依赖项的生命周期管理。这帮助防止资源泄露，如数据库连接未关闭。

第7部分：综合实践示例——构建一个简单API

结合所学，让我们创建一个完整的示例：一个API返回用户信息，依赖项缓存用户数据，并管理生命周期。

from fastapi import FastAPI, Depends
from functools import lru_cache
from contextlib import asynccontextmanager

# 模拟用户数据库
fake_db = {"user1": "Alice", "user2": "Bob"}

# 缓存依赖项：获取用户
@lru_cache()
def get_user(username: str):
    print(f"查询用户: {username}")
    return fake_db.get(username, "用户未找到")

# 生命周期管理：模拟连接
@asynccontextmanager
async def db_connection():
    print("数据库连接打开")
    yield None  # 实际应用中这里可能返回连接对象
    print("数据库连接关闭")

app = FastAPI()

@app.get("/user/{username}")
async def read_user(username: str, user: str = Depends(get_user), _ = Depends(db_connection)):
    return {"username": username, "data": user}

运行应用，访问 http://127.0.0.1:8000/user/user1。第一次访问会看到“数据库连接打开”、“查询用户: user1”和“数据库连接关闭”，之后重复访问同一用户，缓存生效，只显示连接生命周期日志。

关键点：这个示例展示了如何结合缓存和生命周期，优化API性能并管理资源。

第8部分：总结和下一步

恭喜！你已经通过动手实践，理解了FastAPI的依赖项缓存与生命周期。回顾一下：

依赖项：像食材一样，API端点依赖的数据或服务。
缓存：预先存储结果，提高响应速度。
生命周期：管理资源的创建和销毁，避免浪费。

建立信心：你已经成功运行了多个代码示例，从简单API到复杂依赖管理。这是Web开发的坚实第一步！

下一步建议：

探索FastAPI官方文档，了解更多特性。
尝试添加数据库（如SQLite）到你的API。
学习如何部署应用到云端。

继续实践，FastAPI会让你的Python技能发光发热！如果有问题，欢迎查阅社区或教程资源。

备注：本教程内容基于FastAPI版本，确保使用最新库以获得最佳体验。动手修改代码，尝试不同参数，你会学得更快！

上一章 5.2 带参数的依赖项

下一章 5.5 依赖项中的子依赖