FastAPI中实现可选依赖链（A→B→C）的关键是使用带Optional参数的依赖工厂函数，使每层能安全接收None并条件调用下游，同时保持类型兼容与调用可控。
FastAPI 中实现可选的依赖链（A→B→C）的关键是让每个依赖能“跳过”自身，同时不影响后续依赖的注入逻辑。这不能靠简单地设 default=Depends(...) 实现，因为依赖链是同步解析的，必须保证类型兼容和调用顺序可控。
用依赖工厂函数 + Optional 参数控制链路分支
核心思路：把 B 和 C 封装为可接收前驱依赖（如 A 或 None）的工厂函数，并在内部判断是否继续调用下游依赖。这样 A→B→C 不是强制嵌套，而是条件式组装。
- A 是基础依赖（例如认证用户），返回
User | None - B 接收
user: User | None = None，若 user 存在才执行权限检查，否则跳过并返回None或默认上下文 - C 同理，接收
auth_context: Any | None = None，按需增强或透传
用 Depends 包装带默认值的依赖函数
FastAPI 允许依赖函数带默认参数（包括 None），只要类型标注支持 Optional，就能实现“可选注入”。注意：必须显式声明参数默认值为 None，且类型为 Optional[T]，否则 FastAPI 会报错“missing dependency”。
- 定义 B：
def get_b(user: User | None = None) -> PermissionContext | None: - 定义 C：
def get_c(b_ctx: PermissionContext | None = None) -> AccessLevel: -
路由中写：
def route(c: AccessLevel = Depends(get_c)):—— FastAPI 会自动递归解析get_c → get_b → get_user，每层都允许为 None
用独立依赖 + 手动组合替代隐式链
更清晰、更易测试的方式：不强行串成 A→B→C，而是让每个路由显式声明它真正需要的依赖项，再在函数体内按需组合逻辑。
- 保持
get_user()、get_permission()、get_rate_limit()彼此解耦 - 路由中写：
def api(user: User | None = Depends(get_user), perm: PermissionContext | None = Depends(get_permission)): - 函数内判断：
if user and perm: ...，避免强依赖顺序
注意事项与常见陷阱
依赖链中任意一环返回 None，后续环节仍会被调用（除非你主动拦截），所以必须确保下游依赖能安全处理 None 输入；同时，FastAPI 的依赖缓存机制默认对每次请求内的相同依赖只执行一次，即使它被多个上游依赖引用，这点对性能友好但需留意副作用。
- 不要在依赖函数里 raise HTTPException 来“中断链”，这会导致整个请求失败；应返回 None 或空对象，由业务逻辑决定是否拒绝
- 避免循环依赖：比如 C 又反过来 Depends(A)，FastAPI 会直接报错
- 类型提示必须准确，例如用
User | None而非Optional[User]（两者等价，但前者更现代）
