如何在Pydantic中实现字符串字段的大小写不敏感固定值限制？

这个需求确实挺常见的，完全不用把所有大小写组合都硬写进Literal里，有几种简洁的实现方式，我给你详细说说：

方法一：用Annotated + BeforeValidator（推荐，简洁又可复用） #

我们可以给Literal类型套一个前置验证器，先把输入的字符串统一转成小写，再进行固定值验证。这样不管输入是全大写、混合大小写还是小写，都会先被标准化成小写，再检查是否在允许的列表里。

代码示例：

from pydantic import BaseModel, BeforeValidator
from typing import Literal, Annotated

# 定义可复用的大小写不敏感固定值类型
CaseInsensitiveAnimalSpecies = Annotated[
    Literal["antelope", "zebra"],
    BeforeValidator(str.lower)
]

class Animal(BaseModel):
    species: CaseInsensitiveAnimalSpecies

# 测试效果
print(Animal(species="antelope"))  # 正常输出: species='antelope'
print(Animal(species="AnTeLoPe"))  # 自动转小写后验证通过，输出: species='antelope'
# Animal(species="frog")  # 抛出ValidationError: Input should be 'antelope' or 'zebra'

这个方法的好处是，自定义的CaseInsensitiveAnimalSpecies类型可以在其他模型里直接复用，不用重复写验证逻辑。

方法二：用字段验证器自定义逻辑（更灵活） #

如果需要自定义错误提示，或者想保留原始输入的大小写（只是验证时忽略大小写），可以用field_validator实现：

方式1：转小写后交给Literal验证

from pydantic import BaseModel, field_validator
from typing import Literal

class Animal(BaseModel):
    species: Literal["antelope", "zebra"]

    @field_validator('species', mode='before')
    def lowercase_species(cls, value):
        # 先转小写，再交给Literal验证
        return value.lower()

这个写法和方法一的效果完全一致，只是把前置验证逻辑写在了模型内部。

方式2：完全自定义验证逻辑（保留原始输入）

from pydantic import BaseModel, field_validator

class Animal(BaseModel):
    species: str

    @field_validator('species')
    def validate_species(cls, value):
        allowed_species = {"antelope", "zebra"}
        lower_value = value.lower()
        if lower_value not in allowed_species:
            raise ValueError(f"`species must be {', '.join(allowed_species)}")
        # 返回原始输入值，不强制转小写
        return value

# 测试
print(Animal(species="AnTeLoPe"))  # 输出: species='AnTeLoPe'
# Animal(species="frog")  # 抛出ValidationError: `species must be antelope, zebra`

这种方式适合你需要保留用户原始输入格式，但又要验证是否在允许范围内的场景。

为什么你之前的尝试失败了？ #

你用model_config = pydantic.ConfigDict(str_to_lower=True)的方式无效，是因为Pydantic的执行顺序问题：Literal的类型验证会在全局字符串转换（比如str_to_lower）之前执行。也就是说，输入"AnTeLoPe"会先被检查是否属于["antelope", "zebra"]，这一步直接失败抛出错误，之后才会执行转小写的操作，所以达不到预期效果。

备注：内容来源于stack exchange，提问作者LondonRob