无法从.env文件解析set[AnyUrl]：FastAPI+Pydantic配置加载问题

方案1：利用Pydantic内置分隔符配置自动解析 #

修改你的AppSettings模型，添加env_nested_delimiter配置，同时调整.env里的URL格式：

from pydantic import AnyUrl
from pydantic_settings import BaseSettings, SettingsConfigDict


class AppSettings(BaseSettings):
    model_config = SettingsConfigDict(
        env_file=".env", 
        env_file_encoding="utf-8",
        env_nested_delimiter=","  # 添加分隔符配置
    )
    MODE: str = "remote"
    ENVIRONMENT: str = "dev"
    IS_GOOD_ENV: bool = True
    ALLOWED_CORS_ORIGINS: set[AnyUrl]

对应的.env文件去掉多余引号，直接用逗号分隔URL：

MODE=remote
ENVIRONMENT=dev
ALLOWED_CORS_ORIGINS=https://localhost,https://localhost:3000

env_nested_delimiter会告诉Pydantic用逗号拆分字符串值，自动转换为对应的set[AnyUrl]类型，无需额外格式处理。

方案2：自定义字段验证器兼容带引号的格式 #

如果需要保留.env里的带引号写法，可以添加字段验证器手动解析字符串：

from pydantic import AnyUrl, field_validator
from pydantic_settings import BaseSettings, SettingsConfigDict
from typing import Set


class AppSettings(BaseSettings):
    model_config = SettingsConfigDict(
        env_file=".env", 
        env_file_encoding="utf-8"
    )
    MODE: str = "remote"
    ENVIRONMENT: str = "dev"
    IS_GOOD_ENV: bool = True
    ALLOWED_CORS_ORIGINS: Set[AnyUrl]

    @field_validator("ALLOWED_CORS_ORIGINS", mode="before")
    def parse_cors_origins(cls, v):
        if isinstance(v, str):
            # 拆分字符串并清理引号、空格
            origins = [origin.strip().strip('"') for origin in v.split(",")]
            return origins
        return v

对应的.env可保留原格式：

MODE=remote
ENVIRONMENT=dev
ALLOWED_CORS_ORIGINS="https://localhost","https://localhost:3000"

验证器会在Pydantic类型转换前处理原始字符串，拆分后清理每个URL的多余符号，再交给Pydantic转换为集合类型。

原写法失败原因 #

Pydantic默认不会自动识别带引号的逗号分隔字符串为集合类型，这类格式会被当作单个完整字符串，无法匹配set[AnyUrl]的类型要求，因此需要通过分隔符配置或自定义验证器明确解析规则。

内容的提问来源于stack exchange，提问作者Christof Kälin