FastAPI中app.dependency_overrides测试失效及Pydantic-Settings配置问题

问题1：dependency_overrides的使用范围 #

不是只能在FastAPI实例所在文件使用。只要你能在测试代码中正确导入依赖函数get_level_db_settings，就能通过app.dependency_overrides覆盖它。你的测试失败不是因为覆盖本身，而是测试用的依赖函数里仍在尝试加载生产环境的配置文件，导致路径错误。

问题2：测试时配置文件加载失败的解决办法 #

方案1：直接构造测试配置，跳过环境文件加载 #

修改测试用的依赖函数，直接创建LevelDBSettings实例并赋值，完全绕开env_file的加载逻辑：

def get_test_level_db_settings():
    return LevelDBSettings(
        fetch_url="http://localhost:8080/api/v0/fetch",
        read_token="sometest"
    )

同时注意：你的LevelDBSettings类的__init__方法写法错误，会导致初始化异常。BaseSettings的__init__不需要传入model_config，建议删除自定义的__init__方法，或者调整为正确的父类调用方式：

class LevelDBSettings(BaseSettings):
    fetch_url: str
    read_token: str

    model_config = SettingsConfigDict(env_file="dev_default.env", env_file_encoding="utf-8")

    # 要么删掉这个__init__，要么改成以下写法
    # def __init__(self, **kwargs):
    #     super().__init__(**kwargs)

方案2：调整配置文件路径为项目根目录相对路径 #

避免因测试运行路径不同找不到文件，用pathlib基于当前文件位置生成绝对路径：

from pathlib import Path

class LevelDBSettings(BaseSettings):
    fetch_url: str
    read_token: str

    model_config = SettingsConfigDict(
        env_file=Path(__file__).parent / "dev_default.env",
        env_file_encoding="utf-8"
    )

这样不管从项目哪个目录运行代码，都能正确定位到配置文件。

方案3：测试时通过环境变量覆盖配置 #

在测试代码中直接设置环境变量，Pydantic-Settings会优先读取环境变量，跳过env_file的加载问题：

import os

def get_test_level_db_settings():
    os.environ["FETCH_URL"] = "http://localhost:8080/api/v0/fetch"
    os.environ["READ_TOKEN"] = "sometest"
    return LevelDBSettings()

注意测试结束后要清理环境变量，避免影响其他测试用例。

补充：确保依赖覆盖生效 #

测试时要在请求发送前完成依赖覆盖，建议在测试结束后清理覆盖规则，避免污染其他测试：

from fastapi.testclient import TestClient

def test_fetch_data():
    # 覆盖依赖
    app.dependency_overrides[get_level_db_settings] = get_test_level_db_settings
    try:
        # 执行测试逻辑
        client = TestClient(app)
        response = client.get("/your-target-endpoint")
        assert response.status_code == 200
    finally:
        # 清理覆盖
        app.dependency_overrides.clear()

内容的提问来源于stack exchange，提问作者dermoritz