Django中使用Pydantic及Pydantic Settings解析列表遇问题求助

问题核心 #

环境变量ENV_VAR = A,B,C,带尾逗号，直接定义env_var: list[str]会触发Pydantic解析错误；定义为str类型后，后续循环遍历会因类型不匹配失效，自定义验证器未生效大概率是没配置前置处理逻辑。

解决方案1：使用Pydantic v2+的BeforeValidator（推荐） #

通过前置转换器先处理字符串，拆分后过滤空值：

from pydantic import BeforeValidator
from pydantic_settings import BaseSettings

def parse_env_list(value: str) -> list[str]:
    # 拆分字符串并过滤尾逗号产生的空元素，同时去除前后空格
    return [item.strip() for item in value.split(',') if item.strip()]

class Settings(BaseSettings):
    env_var: list[str] = BeforeValidator(parse_env_list)

    class Config:
        env_file = ".env"  # 按你的环境变量加载方式配置

解决方案2：Pydantic v1版本自定义验证器 #

如果使用旧版Pydantic，需给验证器加上pre=True，确保在Pydantic默认解析前执行：

from pydantic import BaseSettings, validator

class Settings(BaseSettings):
    env_var: list[str] = []

    @validator('env_var', pre=True)
    def parse_env_var(cls, value):
        if isinstance(value, str):
            # 处理字符串转列表，过滤空元素
            return [item.strip() for item in value.split(',') if item.strip()]
        return value

    class Config:
        env_file = ".env"

关键注意点 #

• 必须开启前置处理（pre=True或BeforeValidator）：否则Pydantic会先尝试直接将字符串转列表，触发解析错误，自定义逻辑根本不会执行。
• 过滤空元素：处理尾逗号产生的空字符串，避免列表中出现无效空值。

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