FastAPI依赖注入通过函数参数声明实现自动调用与复用，支持依赖链、yield清理、单例作用域及request/app等作用域控制，便于解耦、测试和组合复用。
FastAPI 的依赖注入系统不是装饰器或魔法，而是通过函数参数声明来实现的自动调用与复用机制。它让认证、数据库连接、配置读取等横切关注点从路由逻辑中剥离，代码更清晰、测试更容易、复用更自然。
依赖即函数：声明式调用，自动解析
你只需定义一个普通函数（或类的 __call__ 方法），在路由函数参数中“写上它”，FastAPI 就会在请求时自动执行并注入返回值。不需要手动调用，也不需要全局注册。
- 依赖函数可带参数——这些参数本身也可以是其他依赖，形成依赖链
- 支持
yield写法，用于需要“清理”的场景（如数据库事务提交/回滚、文件关闭） - FastAPI 按需执行，同一个依赖在一次请求中多次被引用，也只运行一次（单例作用域）
作用域控制：从请求到应用级复用
FastAPI 通过 scope 参数控制依赖的生命周期，最常用的是：
- request（默认）：每次 HTTP 请求新建一次实例，适合带请求上下文的对象（如当前用户、请求头解析结果）
- app：整个应用启动时初始化一次，适合数据库连接池、缓存客户端、配置对象
- websocket 和 task：分别用于 WebSocket 连接和后台任务场景
嵌套依赖与条件复用：避免重复逻辑
一个依赖可以依赖另一个依赖，形成可组合的逻辑单元。例如：
立即学习“Python免费学习笔记（深入）”；
-
get_db()依赖get_settings()来读取数据库 URL -
get_current_user()依赖get_token_header()提取 token，再依赖verify_token()解析校验 - 多个路由共用
get_current_user()，但只有带权限要求的才实际触发完整校验链
测试友好：直接传入模拟依赖，无需启动服务器
因为依赖是普通函数，测试时可以直接调用或替换为 mock：
- 单元测试路由函数时，把
get_db替换成内存数据库或Mock - 集成测试中，用真实依赖但隔离外部服务（如用
pytest-mock拦截 HTTP 调用） - FastAPI 的
override_dependencies工具能批量替换，适合端到端测试
不复杂但容易忽略：依赖注入的价值不在“炫技”，而在于让每个函数只专注一件事——业务逻辑本身。
