FastAPI 中的依赖项（如 Depends(get_repository)）在应用启动时即被解析并缓存，因此直接 patch get_repository 无效；应使用官方推荐的 client.dependency_overrides 机制动态注入模拟依赖。
fastapi 中的依赖项（如 `depends(get_repository)`）在应用启动时即被解析并缓存，因此直接 patch `get_repository` 无效；应使用官方推荐的 `client.dependency_overrides` 机制动态注入模拟依赖。
在 FastAPI 应用测试中，常见误区是试图通过 mocker.patch() 替换依赖函数（如 get_repository），但该方式往往失效——根本原因在于：FastAPI 在应用初始化阶段（即 APIRouter 注册路由时）已将 Depends(get_repository) 解析为一个固定的依赖注入对象，并将其缓存在内部依赖图中。这意味着，无论后续如何 patch 原函数，运行时实际调用的仍是初始化时绑定的原始实现。
✅ 正确做法是利用 FastAPI 内置的 TestClient.dependency_overrides 字典，它专为测试场景设计，允许你在单次请求生命周期内临时替换任意依赖函数或可调用对象。
以下为修正后的完整测试示例（基于你的项目结构）：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
# tests/routes/resource/resource_test.py
from src.routes.resource.resource import get_repository, router
from src.repository.repository import Repository
from src.routes.resource.resource import Resource # 确保导入正确模型
from fastapi.testclient import TestClient
from unittest.mock import MagicMock
# 假设 app 已正确导入（例如：from src.main import app）
client = TestClient(app)
def test_get_resources() -> None:
# 创建模拟仓库实例
mock_repo = MagicMock(spec=Repository)
mock_repo.list.return_value = [
Resource(id=1, name="Something", age=20),
Resource(id=2, name="Something2", age=22),
]
# ✅ 关键：使用 dependency_overrides 替换依赖
client.dependency_overrides[get_repository] = lambda: mock_repo
response = client.get("/resources/")
# 清理：避免影响其他测试
client.dependency_overrides.clear()
assert response.status_code == 200
content = response.json()
assert len(content) == 2
assert content[0]["name"] == "Something"? 注意事项：
-
dependency_overrides是TestClient实例级别的配置，无需 mocker 或 patch，更安全、更符合 FastAPI 设计哲学； - 务必在测试结束前调用
client.dependency_overrides.clear()（或重置为{}），否则该覆盖会污染后续测试； - 若需复用模拟逻辑，可将其封装为 fixture，配合
autouse=True和scope="function"自动管理生命周期； - 确保
mock_repo的方法签名与真实Repository.list()一致（如返回类型、异常行为），必要时使用spec=或autospec=True提升模拟保真度。
总结：FastAPI 的依赖注入是声明式且提前绑定的，测试时应“绕过”模块加载逻辑，直接干预依赖解析环节——dependency_overrides 正是为此而生的标准方案，既简洁又可靠。
