如何在 FastAPI 测试中正确替换依赖（而非 patch 函数）-Python教程-PHP中文网

如何在 FastAPI 测试中正确替换依赖（而非 patch 函数）

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 提升模拟保真度。