如何在pydantic-settings中正确实现鉴别联合类型配置？

你的环境变量命名与模型结构不匹配，导致Pydantic无法正确映射配置：

• 你的RunSettings模型中，run是一个嵌套子模型，Pydantic Settings默认用双下划线__区分嵌套字段层级，但你直接使用了RUN_TYPE和POLLING_INTERVAL这类顶级环境变量命名，Pydantic无法将它们关联到run子模型中，最终导致run字段因缺失值触发验证错误。

有两种方式可以解决这个问题：

方案1：调整环境变量命名，适配嵌套模型结构 #

按照Pydantic的嵌套字段规则，将环境变量改为以下格式，用双下划线连接父字段与子字段：

RUN__RUN_TYPE="polling" RUN__POLLING_INTERVAL=15 python your_script.py

这样Pydantic会自动将RUN__RUN_TYPE映射到run.run_type，RUN__POLLING_INTERVAL映射到run.polling_interval，正确加载对应模式的配置。

方案2：重构模型，简化环境变量使用 #

如果觉得嵌套命名不够直观，可以重构模型，让配置直接对应顶级环境变量：

from pydantic import BaseModel, Literal, Annotated, Field, Union
from pydantic_settings import BaseSettings

class WebhookSettings(BaseModel):
    run_type: Literal["webhook"]
    webhook_url: str
    webhook_path: str

class PollingSettings(BaseModel):
    run_type: Literal["polling"]
    polling_interval: int

class RunSettings(BaseSettings):
    __root__: Annotated[Union[WebhookSettings, PollingSettings], Field(discriminator="run_type")]

# 加载配置
settings = RunSettings.model_validate_env()
print(settings.root)

此时直接使用你原来的环境变量命令即可：

RUN_TYPE="polling" POLLING_INTERVAL=15 python your_script.py

__root__字段会让Pydantic直接将环境变量解析为Union类型中的对应子模型，无需嵌套命名。

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