Pydantic自定义配置源无法访问默认属性，求正确获取方式

为什么会出现AttributeError？ #

这是正常行为。原因在于自定义配置源函数的执行时机早于Settings类的实例化：

• 当你在json_config_settings_source中直接访问Settings.config_url或settings.config_url时，此时Settings还只是一个类对象，而非实例。Pydantic的字段属性（如config_url）是在实例化阶段才会被绑定到实例上的，类本身不会直接拥有这些属性。
• 而__fields__（Pydantic v1）或model_fields（Pydantic v2）是Pydantic在类定义阶段就生成的字段元数据容器，所以你能在这里看到config_url的定义，但这属于内部/半公开的属性集合。

不推荐直接用__fields__访问 #

直接操作__fields__并不规范，因为它是Pydantic的内部实现细节，后续版本可能会变更。Pydantic v2已经将公开的字段元数据入口改为model_fields，所以即使要访问元数据，也应该优先用model_fields而非__fields__。

最优实现方案 #

要实现“通过API端点配置覆盖当前配置”的需求，正确的做法是先获取config_url的值（从默认值、环境变量或其他配置源），再调用API拉取配置并返回。这里提供两种可靠的实现方式：

方式1：直接读取默认值或环境变量

如果config_url的取值仅来自默认值或环境变量，可直接在配置源中手动获取：

from typing import Type, Dict, Any
from pydantic_settings import BaseSettings, SettingsConfigDict
import requests
import os

def json_config_settings_source(settings_cls: Type[BaseSettings]) -> Dict[str, Any]:
    # 获取config_url：优先取环境变量，其次用字段默认值
    config_url = os.getenv(
        'CONFIG_URL', 
        settings_cls.model_fields['config_url'].default
    )
    
    if not config_url:
        return {}  # 无API地址则返回空配置
    
    # 调用API获取配置
    response = requests.get(config_url)
    response.raise_for_status()
    return response.json()

class Settings(BaseSettings):
    config_url: str | None = None
    # 其他配置字段...
    
    model_config = SettingsConfigDict(
        settings_sources=[
            BaseSettings.default_settings_source,  # 保留默认配置源（如.env、环境变量）
            json_config_settings_source,  # 放在默认源之后，用API配置覆盖默认值
        ]
    )

方式2：加载其他配置源获取config_url

如果config_url可能来自多个配置源（如.env文件、命令行参数），需要先加载除当前自定义源之外的其他配置源，避免递归实例化：

def json_config_settings_source(settings_cls: Type[BaseSettings]) -> Dict[str, Any]:
    # 仅加载默认配置源（排除当前自定义源），获取已解析的config_url
    default_sources = [
        source for source in settings_cls.model_config['settings_sources']
        if source != json_config_settings_source
    ]
    temp_settings = settings_cls(_settings_sources=default_sources)
    config_url = temp_settings.config_url
    
    if not config_url:
        return {}
    
    response = requests.get(config_url)
    response.raise_for_status()
    return response.json()

关键注意点 #

• 配置源的执行顺序很重要：确保自定义源在默认源之后，这样config_url能先从默认源（如环境变量）加载，再用API配置覆盖。
• 避免递归实例化：直接调用settings_cls()会触发所有配置源（包括当前自定义源），导致无限递归，所以需要指定_settings_sources参数限制加载的源。

内容的提问来源于stack exchange，提问作者M.Armoun