Pydantic开启allow_mutation时如何允许改值同时禁止修改字段类型?
可突变Pydantic模型实现「允许改值、禁止改类型」的方案
你遇到的默认场景问题本质是:Pydantic默认开启宽松类型自动转换,哪怕给int类型的字段传入可转换的字符串、浮点数,都会自动完成类型转换后赋值,不会触发类型错误。要实现目标效果,需要在开启allow_mutation的基础上,同时打开两个能力:
- 字段赋值时自动触发类型校验
- 关闭自动类型强制转换,不匹配原生类型的赋值直接拦截
具体实现方法
方法1:全局开启严格校验模式(推荐,无需逐字段修改)
直接在模型的Config类中调整配置即可,适配你现有的类结构:
from pydantic import BaseModel class AppConfig(BaseModel): class Config: allow_mutation = True # 开启赋值时自动触发校验,是拦截类型不匹配的必要前提 validate_assignment = True # 全局开启 *strict* 严格模式,禁止所有自动类型强制转换 strict = True a: int = 33 b: float = 22.0
测试效果
- 同类型赋值完全正常:
config = AppConfig() config.a = 44 # 无报错,正常修改值
- 跨类型赋值直接抛出校验错误:
config.a = '44'
触发的报错提示:
pydantic_core.ValidationError: 1 validation error for AppConfig a Input should be a valid integer [type=int_type, input_value='44', input_type=str]
方法2:逐字段指定严格类型(控制粒度更灵活)
如果需要针对单个字段做严格类型控制,不影响其他字段的宽松转换逻辑,可以用Pydantic内置的严格类型替换原本的类型注解:
from pydantic import BaseModel, StrictInt, StrictFloat class AppConfig(BaseModel): class Config: allow_mutation = True validate_assignment = True # 仅a、b字段开启严格类型校验 a: StrictInt = 33 b: StrictFloat = 22.0 c: str = "test" # 这个字段依然支持宽松的类型转换
这种方式的拦截行为和全局严格模式完全一致,只是可以单独对需要强类型约束的字段生效,不需要全局调整规则。
注意事项
- 必须搭配 validate_assignment = True 使用:如果只开严格模式不开这个开关,修改字段时不会触发任何校验,哪怕类型不对也会直接把值写入实例,完全达不到拦截效果。
- 严格模式不会限制同类型的合法赋值:比如给
int类型字段赋任意整数(正、负、0)、给float字段赋任意浮点数的操作,都和正常的可突变模型行为没有区别,只会拦截需要靠自动转换才能匹配类型的赋值。 - Pydantic v2适配提示:如果使用v2版本,将原本的内层
Config类替换为model_config = ConfigDict(allow_mutation=True, validate_assignment=True, strict=True)即可,核心逻辑完全一致。
内容的提问来源于stack exchange,提问作者Amir
相关产品推荐
相关产品推荐

