在Pydantic的实际使用中，我们经常需要对已有的模型实例进行复制并修改部分字段，此时默认的复制操作不会重新触发字段的验证规则，可能导致修改后的数据不符合模型的约束条件。要解决这个问题，需要采用特定的方式在复制过程中强制执行字段验证。
默认复制行为的问题
Pydantic的模型实例提供了model_copy方法用于复制实例，该方法默认不会重新执行字段验证。比如我们定义一个带有字段约束的模型：
from pydantic import BaseModel, Field
class UserModel(BaseModel):
age: int = Field(ge=0, description="年龄必须大于等于0")
name: str = Field(min_length=1, description="姓名不能为空")
# 创建合法实例
user = UserModel(age=20, name="张三")
# 复制时修改age为非法值，默认不会报错
new_user = user.model_copy(update={"age": -5})
print(new_user.age) # 输出-5，不符合ge=0的约束
上述代码中，复制后的实例new_user的age字段为-5，违反了模型的约束，但复制过程没有抛出验证错误，这就是默认复制行为的问题。
强制执行字段验证的方法
方法一：使用model_copy的context参数配合验证器
可以在模型中定义验证器，结合model_copy的上下文参数，在复制时触发验证。示例代码如下：
from pydantic import BaseModel, Field, model_validator
class UserModel(BaseModel):
age: int = Field(ge=0, description="年龄必须大于等于0")
name: str = Field(min_length=1, description="姓名不能为空")
@model_validator(mode="after")
def check_fields(self):
# 这里可以添加自定义验证逻辑，默认复制时不会触发
if self.age < 0:
raise ValueError("年龄不能小于0")
if not self.name:
raise ValueError("姓名不能为空")
return self
# 创建合法实例
user = UserModel(age=20, name="张三")
# 复制时传入context触发验证，或者重新构造实例
try:
new_user = UserModel(**user.model_dump(), age=-5)
except ValueError as e:
print(f"验证失败：{e}") # 输出验证失败：年龄不能小于0
方法二：复制后重新构造实例
最直接的方式是将原实例的数据导出，修改后再重新构造新的模型实例，这样会自动触发完整的字段验证：
from pydantic import BaseModel, Field
class UserModel(BaseModel):
age: int = Field(ge=0, description="年龄必须大于等于0")
name: str = Field(min_length=1, description="姓名不能为空")
user = UserModel(age=20, name="张三")
# 导出原实例数据，修改后重新构造
user_data = user.model_dump()
user_data["age"] = -5
try:
new_user = UserModel(**user_data)
except ValueError as e:
print(f"构造实例失败：{e}") # 输出构造实例失败：年龄不能小于0
方法三：自定义复制方法
可以在模型类中自定义复制方法，在方法内部主动触发验证：
from pydantic import BaseModel, Field
class UserModel(BaseModel):
age: int = Field(ge=0, description="年龄必须大于等于0")
name: str = Field(min_length=1, description="姓名不能为空")
def copy_with_validate(self, update: dict = None):
# 合并原数据和更新数据
data = self.model_dump()
if update:
data.update(update)
# 重新构造实例触发验证
return self.__class__(**data)
user = UserModel(age=20, name="张三")
try:
new_user = user.copy_with_validate(update={"age": -5})
except ValueError as e:
print(f"复制验证失败：{e}") # 输出复制验证失败：年龄不能小于0
不同方法的适用场景
我们可以通过下表对比不同方法的特点，选择适合自己场景的方案：
| 方法 | 优点 | 缺点 | 适用场景 |
|---|---|---|---|
| 重新构造实例 | 逻辑简单，无需额外代码 | 需要手动导出和合并数据 | 复制逻辑简单的场景 |
| 自定义复制方法 | 封装性好，调用方便 | 需要额外定义方法 | 项目中频繁需要复制并验证的场景 |
| 结合验证器 | 可以复用已有的验证规则 | 需要理解上下文参数的使用 | 已有复杂验证逻辑的模型 |
注意事项
- 如果模型包含嵌套的子模型，重新构造实例时会自动递归触发子模型的验证，无需额外处理。
- 使用
model_dump导出数据时，默认会导出所有字段，如果不需要某些字段可以传入exclude参数。 - 验证失败时Pydantic会抛出
ValidationError异常，实际使用中可以根据需要捕获并处理该异常。
通过上述方法，我们可以在Pydantic模型复制后强制执行字段验证，确保复制后的实例数据始终符合模型的约束规则，避免非法数据流入后续的业务逻辑中。
Pydantic模型复制字段验证pydantic_validatemodel_copy修改时间：2026-06-24 10:06:36