FastAPI依赖注入详解：Depends模块实战应用

FastAPI 的 Depends 并非传统意义上的“自动依赖注入”，而是一个轻量级、按需执行的运行时调用调度器——它在每次请求中严格依据依赖图顺序同步或异步调用你提供的可调用对象，并将返回值注入路径函数参数，但完全不管理对象生命周期、单例状态或资源清理；真正复用（如单请求内数据库会话）需手动借助生成器+yield+try/finally实现，跨请求复用则必须依赖外部库（如SQLAlchemy连接池）；嵌套依赖会被智能缓存（同 callable 在单次请求中仅执行一次），但极易因闭包、装饰器或lambda误用导致重复执行；测试时须通过 app.dependency_overrides 精准替换依赖，硬编码则彻底丧失可测性——理解这一本质，才能避开资源泄漏、性能瓶颈与测试失效等高频陷阱。

FastAPI 里 Depends 不是“自动注入”，而是“运行时调用”

很多人以为 Depends 像 Spring 那样在启动时扫描、绑定、代理，其实它只是个轻量级的函数调度器：每次请求进来，FastAPI 按依赖图顺序执行你传给 Depends() 的可调用对象（函数、类、生成器），把返回值塞进路径函数参数里。它不管理生命周期，也不做单例控制——除非你自己写。

• 常见错误现象：Depends(db_session) 每次都新建一个数据库连接，没关；或者用了 yield 但忘了加 try/finally 清理资源
• 使用场景：鉴权校验、数据库会话、配置读取、限流计数器、日志上下文初始化
• 参数差异：Depends(func) 是同步调用；Depends(async_func) 必须是 async def，且路径函数也得是 async，否则报 TypeError: object async_generator can't be used in 'await' expression

怎么让 Depends 复用同一个实例（比如数据库 session）

FastAPI 默认每次调用依赖函数都重新执行，要复用就得自己控制作用域。最常用的是用生成器 + yield 配合 try/finally，但注意：这只能保证「单次请求内」复用，不是全局单例。

• 别直接 return SessionLocal()，那是新实例；要用 yield session 让 FastAPI 在路径函数结束后触发清理
• 如果想跨请求复用（比如连接池），得靠外部库（如 sqlalchemy.ext.asyncio.AsyncSession 自带连接池），Depends 本身不负责这个
• 示例片段：

  def get_db():
      db = SessionLocal()
      try:
          yield db
      finally:
          db.close()

  然后在路径函数中写 db: Session = Depends(get_db)

Depends 嵌套依赖时的执行顺序和缓存规则

FastAPI 会解析整个依赖树，对同一依赖函数（相同 callable 对象）在单次请求中只执行一次，即使被多个地方 Depends 引用。但要注意“相同 callable”的判定很严格：闭包不同、装饰器没处理好、lambda 都算不同实例。

• 常见错误现象：写了两个一模一样的 Depends(get_current_user)，结果 get_current_user 被执行了两次——大概率是因为其中一个被 @lru_cache 包裹而另一个没包，或用了带默认参数的 lambda
• 嵌套场景举例：Depends(get_admin_user) 内部又调用了 Depends(get_current_user)，FastAPI 会先跑 get_current_user，再跑 get_admin_user，且后者能拿到前者返回值
• 性能影响：依赖链太深（>5 层）可能拖慢请求初始化，尤其含 I/O 操作时；建议把耗时操作提前到中间件或后台任务里

测试时绕过 Depends 或替换为 Mock 依赖

单元测试里不能真连数据库或调真实鉴权服务，必须能替换依赖。FastAPI 提供了 override 机制，但只对全局 Depends 生效，对局部定义的函数无效。

• 正确做法：在应用实例上设置 app.dependency_overrides[get_db] = override_get_db，其中 override_get_db 是个返回 mock session 的函数
• 容易踩的坑：忘记在测试结束时清空 app.dependency_overrides，导致后续测试被污染；应该用 app.dependency_overrides.clear() 或 pytest fixture 管理
• 路径函数里硬编码 Depends(lambda: real_thing()) 就没法 override——这种写法等于自废 dependency injection 能力

依赖注入的边界其实很薄：FastAPI 只管“谁先调、谁后调、调几次”，不负责对象生命周期、线程安全、连接池管理。这些都得你根据实际使用的库（SQLAlchemy、Redis、JWT 库）来补全，否则看似解耦，实则埋雷。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~