如何避免Pydantic触发ValidationError中断程序，仅打印警告继续运行

针对接口未稳定、校验失败不需要阻塞程序的场景，有两种常用实现方案： #

方案1：通用包装函数处理（无需修改模型定义） #

适合只有少量模型需要该逻辑的场景，通过捕获ValidationError异常输出警告，校验失败时跳过校验生成实例，不中断程序运行：

import logging
from pydantic import BaseModel, NonNegativeInt, ValidationError
# 配置日志输出
logging.basicConfig(level=logging.WARNING)
logger = logging.getLogger(__name__)
# 原有模型定义不变
class Person(BaseModel):
    name: str
    age: NonNegativeInt
    details: None
# 通用安全实例化函数
def safe_create_model(model_cls, **kwargs):
    try:
        return model_cls(**kwargs)
    except ValidationError as e:
        # 输出完整校验错误日志
        logger.warning(f"{model_cls.__name__} 字段校验失败：\n{e}")
        # 跳过校验直接构造实例，保留传入的所有原始值
        return model_cls.construct(**kwargs)
# 调用示例
p1: Person = safe_create_model(Person, name='Alice', age=30, details=None)
print(p1)
p2: Person = safe_create_model(Person, name='Bob', age=40, details={'height': 1.70, 'weight': 91})
print(p2)

运行后会输出警告日志，同时程序不会中断，p2实例会保留传入的details原始值。 #

方案2：自定义BaseModel基类（全局统一处理） #

如果项目中大量模型都需要该逻辑，可以重写模型父类的初始化方法，全局默认处理校验异常，不需要修改原有模型的调用代码：

import logging
from pydantic import BaseModel as PydanticBaseModel, ValidationError
# 全局日志配置
logging.basicConfig(level=logging.WARNING)
logger = logging.getLogger(__name__)
# 自定义全局模型基类
class BaseModel(PydanticBaseModel):
    def __init__(__pydantic_self__, **data):
        try:
            super().__init__(**data)
        except ValidationError as e:
            logger.warning(f"{__pydantic_self__.__class__.__name__} 校验失败：\n{e}")
            # 跳过校验直接赋值所有传入字段
            for field_name, field_value in data.items():
                setattr(__pydantic_self__, field_name, field_value)
# 业务模型继承自定义基类即可
class Person(BaseModel):
    name: str
    age: NonNegativeInt
    details: None
# 原有调用逻辑无需修改
p1: Person = Person(name='Alice', age=30, details=None)
print(p1)
p2: Person = Person(name='Bob', age=40, details={'height': 1.70, 'weight': 91})
print(p2)

注意事项 #

• 跳过校验后的模型实例字段不保证符合原定义的类型约束，后续使用时需要做好兼容处理，避免产生其他运行时错误
• 如果你使用的是Pydantic V2版本，仅需调整ValidationError的导入路径和对应API即可，核心逻辑不变
• 如果仅需要部分字段放宽校验，也可以单独给对应字段添加自定义验证器，捕获验证失败的场景打警告后返回原值即可，无需全局处理

内容的提问来源于stack exchange，提问作者RaamEE