如何让Pydantic模型同时支持new_name与old_name两种字段名的输入？

看起来你遇到的是Pydantic v2兼容新旧输入字段名的典型问题，想要让UserCreate同时接受new_name和old_name作为有效输入字段，我们可以用Pydantic 2提供的AliasChoices特性来完美解决，这正好适配你需要兼容两种字段名的场景。

具体解决方案 #

1. 导入必要的工具类

首先从Pydantic中导入AliasChoices，它允许我们为单个字段指定多个验证阶段的别名：

from pydantic import AliasChoices, Field
from sqlmodel import SQLModel

2. 修改UserCreate模型

把原来的alias="old_name"替换为validation_alias=AliasChoices("old_name", "new_name")，这样模型在解析输入时，无论是传old_name还是new_name都会被正确映射到new_name字段：

class UserCreate(SQLModel):
    user: str = Field()
    # 核心修改：允许输入时使用old_name或new_name
    new_name: str = Field(validation_alias=AliasChoices("old_name", "new_name"))
    description: str | None = Field(default=None)

3. 保持数据库模型的原有配置

你的数据库模型Users中的alias="old_name"是用来映射数据库列名的，这个完全不需要改动——它负责的是模型与数据库表字段的映射，和输入验证的别名逻辑是分离的：

from uuid import UUID, uuid4
from sqlmodel import SQLModel, Field

class Users(SQLModel, table=True):
    id: UUID = Field(default_factory=uuid4, primary_key=True)
    user: str = Field(index=True)
    # 数据库列名为old_name，模型字段为new_name，这个映射保持不变
    new_name: str = Field(index=True, alias="old_name")
    description: str | None = Field(default=None, nullable=True)

为什么原来的方法会报错？ #

在Pydantic v2中，单独使用alias参数会同时将其设置为验证别名和序列化别名。也就是说如果你只写alias="old_name"，那么输入时只能传old_name，传new_name就会触发422验证错误（因为模型会认为new_name是必填但缺失的字段）。

而AliasChoices就是专门为这种“多个输入别名映射到同一个字段”的场景设计的，它明确告诉Pydantic：输入时传这几个名字里的任意一个都算有效。

测试验证 #

现在你的API就可以同时兼容两种输入格式了：

• 用old_name的请求体：

[
  {
    "user": "Tom",
    "old_name": "sssss",
    "description": "data engineer"
  }
]

• 用new_name的请求体：

[
  {
    "user": "Tom",
    "new_name": "sssss",
    "description": "data engineer"
  }
]

两种格式都会被正确解析为UserCreate实例，不会再返回422错误。

额外提示 #

如果之后需要序列化输出时固定使用某个字段名（比如统一返回new_name），可以再给new_name字段加上serialization_alias="new_name"，这样返回给前端的字段名就会统一：

new_name: str = Field(
    validation_alias=AliasChoices("old_name", "new_name"),
    serialization_alias="new_name"
)

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