FastAPI可通过依赖函数接收Query参数实现动态切换依赖实例：在get_processor等依赖中根据mode值返回不同DataProcessor子类实例，或用ProcessorFactory封装创建逻辑，结合Depends链式调用按query参数调整运行时行为，注意请求隔离与参数必填校验。
FastAPI 的依赖注入本身不直接支持“根据 query 参数动态切换依赖实例”，但可以通过几种灵活方式实现类似效果：核心思路是让依赖函数接收 query 参数，再基于参数值返回不同逻辑或实例。
在依赖函数中直接接收 query 参数
FastAPI 允许依赖函数声明路径/查询/请求等参数，只要这些参数本身也是合法的依赖（比如 Query、Path 或其他已注册依赖）。你可以在依赖里读取 query 值，然后分支处理：
- 定义一个依赖函数，参数包含
mode: str = Query("default") - 在函数内部用
if mode == "fast": ... elif mode == "safe": ...返回不同服务实例或配置 - 该依赖仍可被其他路由复用，且每次请求都按当前 query 实时计算
示例：
from fastapi import Depends, Query
from typing import Annotated
<p>class DataProcessor:
def process(self, data):
raise NotImplementedError</p><p>class FastProcessor(DataProcessor):
def process(self, data): return f"fast: {data}"</p><p>class SafeProcessor(DataProcessor):
def process(self, data): return f"safe: {data}"</p><p>def get_processor(mode: Annotated[str, Query()] = "default") -> DataProcessor:
if mode == "fast":
return FastProcessor()
elif mode == "safe":
return SafeProcessor()
else:
return DataProcessor() # fallback</p><p>@app.get("/process")
def process_data(
data: str,
processor: DataProcessor = Depends(get_processor)
):
return {"result": processor.process(data)}
用工厂模式封装动态选择逻辑
把“根据 query 创建依赖”的逻辑抽成工厂函数，保持依赖函数简洁、可测、易扩展：
- 定义
ProcessorFactory类，带create(mode: str)方法 - 依赖函数只负责调用工厂，不写 if/else 分支
- 后续新增模式（如 "mock", "batch"）只需改工厂，不碰依赖声明
结合 Depends 链式调用做条件注入
当多个依赖存在层级关系（例如数据库连接 → 事务管理 → 业务服务），你可以让上层依赖接收下层依赖+query 参数，动态包装或代理：
- 例如：一个
get_service依赖接收db: Session = Depends(get_db)和env: str = Query("prod") - 再根据
env决定是否启用缓存、重试、日志级别等中间行为 - 这样 query 不改变依赖类型，但改变了其运行时行为
注意生命周期与状态隔离
每个请求的依赖实例默认是独立的（request-scoped），所以基于 query 创建的对象天然隔离。但要避免在依赖中缓存跨请求的数据（如用模块变量存 processor 实例），否则可能造成 query 判断错乱或状态污染。
不复杂但容易忽略：确保 query 参数有默认值或标记为必需（Query(...)），否则 FastAPI 可能因缺失参数而报 422 错误，而不是进入你的分支逻辑。
