FastAPI 高级特性：依赖注入与应用模式

📦 1. 依赖注入概念与基础

依赖注入定义与作用

依赖注入（Dependency Injection，简称 DI）是一种常见的设计模式，它通过解耦代码中的依赖关系，从而使得系统更加灵活和易于测试。FastAPI 中的依赖注入功能在创建Web应用时尤其有用，能够有效地降低耦合度，提高代码的可维护性和可测试性。

在 FastAPI 中，依赖注入的基本思路是：将一个函数、对象或者其他外部资源作为参数传递给处理请求的路径操作函数（即路由处理函数）。这些外部资源通常是应用中的共享状态或者服务，如数据库连接、外部 API 客户端等。FastAPI 将自动处理这些依赖的创建、销毁和传递，开发者无需手动管理这些资源。

from fastapi import FastAPI, Dependsapp = FastAPI()def get_query_param(q: str = "default"):return q@app.get("/items/")
async def read_item(query_param: str = Depends(get_query_param)):return {"query_param": query_param}

依赖注入的优势

解耦合： 通过依赖注入，应用中的各个模块和组件能够相互独立、互不干扰。组件之间只通过接口交互，而不直接引用具体实现。
可测试性： 由于依赖被自动注入，测试时可以轻松替换依赖，使用 mock 对象来模拟外部依赖，简化单元测试。
可扩展性： 在需要扩展功能时，依赖注入可以减少对现有代码的修改。只需注入新的依赖即可，无需在每个路由处理函数中手动调整。
清晰的资源管理： FastAPI 自动管理依赖的生命周期，避免了重复创建和销毁对象的问题，减少了内存泄漏的风险。

依赖注入的使用场景

数据库连接： 通常，应用会使用数据库进行数据存取操作，数据库连接池可以作为依赖注入到路由函数中。
身份验证： 用户身份验证可以作为一种依赖，处理请求时自动注入当前用户的身份信息。
外部API调用： 如果应用需要调用其他服务的API，API 客户端可以作为依赖注入进来，简化管理和使用。

通过依赖注入，FastAPI 使得复杂的应用逻辑得以模块化，并提高了系统的可维护性。

🔑 2. 依赖注入的生命周期

在 FastAPI 中，依赖注入的生命周期是一个重要的概念。理解生命周期的管理，有助于确保资源在正确的时间被创建和销毁。

生命周期管理

FastAPI 提供了几种不同类型的依赖生命周期，允许开发者控制依赖对象的创建和销毁方式。常见的生命周期有：

请求生命周期（Request-scoped）： 每次请求时，FastAPI 都会创建一个新的依赖实例。请求结束时，FastAPI 会销毁这个实例。
单例生命周期（Singleton）： 依赖实例在整个应用生命周期内只会创建一次，之后每次请求都共享这个实例。适用于数据库连接池等需要长时间保持连接的场景。
每次调用（Per-call）： 每次调用依赖时都会创建新的实例，适用于轻量级依赖，避免重复使用同一实例。

通过 Depends 和 ContextManager，FastAPI 为开发者提供了灵活的生命周期管理方式。例如，当需要创建一个数据库连接并且在请求结束时自动关闭它时，可以使用 Depends 来声明生命周期。

示例：数据库连接池

from fastapi import FastAPI, Depends
from sqlalchemy import create_engine
from sqlalchemy.orm import sessionmaker
from contextlib import contextmanager# 创建数据库连接池
SQLALCHEMY_DATABASE_URL = "sqlite:///./test.db"
engine = create_engine(SQLALCHEMY_DATABASE_URL, connect_args={"check_same_thread": False})
SessionLocal = sessionmaker(autocommit=False, autoflush=False, bind=engine)# 定义依赖
@contextmanager
def get_db():db = SessionLocal()try:yield dbfinally:db.close()app = FastAPI()@app.get("/users/")
def get_users(db: Session = Depends(get_db)):# 在这里可以进行数据库操作return {"msg": "获取用户列表"}

生命周期的选择

短生命周期（Request-scoped）： 适合数据库连接、外部API请求等需要在请求范围内建立并销毁的依赖。每个请求都会新建一个实例，处理完后销毁。
长生命周期（Singleton）： 适用于配置加载、缓存服务、数据库连接池等不需要频繁创建销毁的对象。这些依赖在应用启动时创建，直到应用关闭。

通过生命周期管理，FastAPI 确保了资源的高效利用，并能在整个应用的生命周期中合理地管理依赖关系。

🛠 3. FastAPI 中依赖注入的应用实例

在 FastAPI 中，依赖注入不仅限于简单的函数注入，它也可以处理复杂的应用需求，如用户身份验证、配置管理和请求上下文等。

依赖注入的实际应用

数据库依赖

在实际项目中，数据库连接往往作为一种常见的依赖注入。为了提高数据库操作的效率，开发者通常会使用数据库连接池。在 FastAPI 中，可以通过 Depends 来注入数据库连接，从而简化数据库操作的管理。

身份验证依赖

身份验证模块也是 FastAPI 中常见的依赖注入场景。可以通过依赖注入处理用户身份验证逻辑，提取当前用户的信息，或者判断用户是否已通过身份认证。

from fastapi import Depends, HTTPException
from fastapi.security import OAuth2PasswordBeareroauth2_scheme = OAuth2PasswordBearer(tokenUrl="token")# 获取当前用户的依赖
def get_current_user(token: str = Depends(oauth2_scheme)):# 模拟身份验证过程user = {"username": "admin"}if not user:raise HTTPException(status_code=401, detail="Invalid token")return user@app.get("/profile")
def read_profile(current_user: dict = Depends(get_current_user)):return {"user": current_user}

复杂依赖注入

在某些情况下，可能需要处理多个依赖的组合。这时，可以通过嵌套依赖或者依赖链来构建复杂的依赖结构。FastAPI 支持依赖的组合和嵌套，开发者可以通过链式调用的方式注入多个依赖。

def get_query_params(q: str = "default"):return qdef get_current_user(token: str = Depends(oauth2_scheme)):# 这里模拟一个用户获取过程return {"user_id": 1}@app.get("/items/")
def read_item(query: str = Depends(get_query_params), user: dict = Depends(get_current_user)):return {"query": query, "user": user}

🚀 4. 高级依赖注入技巧与最佳实践

1. 使用 `Depends` 优化代码结构

FastAPI 的 Depends 可以用来注入复杂依赖关系，并将业务逻辑分离到单独的函数中。通过这种方式，可以让每个依赖函数只专注于自己的职责，代码更加清晰和易于维护。

2. 使用 `ContextManager` 管理复杂资源

对于需要进行资源管理的场景，可以通过 Python 的 contextlib 库中的 contextmanager 来创建上下文管理器。这种方式能够更好地控制依赖的生命周期，尤其是在数据库连接、文件操作等资源管理上。

3. 模块化依赖管理

FastAPI 支持通过依赖注入进行模块化。可以将多个依赖按功能模块组织到不同的文件和函数中，提高代码的可复用性。

4. 动态依赖注入

在一些复杂的应用中，依赖关系可能会根据请求的不同而有所变化。FastAPI 允许动态决定依赖注入的具体内容，比如根据请求头中的信息动态选择不同的身份验证方式或数据库。

FastAPI 高级特性：依赖注入与应用模式