类继承场景下的Pydantic验证错误排查求助

这个错误的核心是自定义元类MetaPersistent与Pydantic的元类逻辑不兼容，加上代码中存在语法错误，共同导致Pydantic的验证器调用签名异常：

1. 元类继承方式错误：通过type(BaseModel)间接继承Pydantic元类，而非直接使用官方暴露的ModelMetaclass，导致元类逻辑冲突。
2. 语法错误：Persistent类中ref属性的return语句未缩进，破坏了类结构，干扰Pydantic验证器生成。
3. 动态类生成逻辑：未确保动态创建的Repository和Ref类不影响主模型的Pydantic验证流程。

步骤1：修复语法错误 #

首先修正Persistent类中ref属性的缩进问题：

class Persistent(BaseModel, metaclass=MetaPersistent, skip_meta_init=True):
    id: Optional[Id] = Field(None, title="Unique object Id", alias="_id")

    @property
    def ref(self) -> RefBase[Self]:
        return self.Ref(self.id)  # 修复缩进，确保属于@property方法

    async def store(self) -> RefBase[Self]:
        if self.id:
            await repository_of(self).update_obj(self)
        else:
            await repository_of(self).insert_obj(self)

        return self.ref

步骤2：修正元类继承逻辑 #

根据你使用的Pydantic版本，直接继承官方的ModelMetaclass，确保元类逻辑完全兼容：

针对Pydantic v2 #

from pydantic._internal._model_construction import ModelMetaclass
from typing import ClassVar, TypeVar, Self

Self = TypeVar('Self')

class MetaPersistent(ModelMetaclass):
    Ref: ClassVar[type[RefBase[Self]]]
    Repository: ClassVar[type[RepositoryBase[Self]]]

    def __new__(cls, name, bases, namespace, skip_meta_init=False, **kwargs):
        # 优先让Pydantic元类处理类创建流程
        return super().__new__(cls, name, bases, namespace, **kwargs)

    def __init__(self, name, bases, namespace, skip_meta_init=False, **kwargs):
        super().__init__(name, bases, namespace, **kwargs)
        
        if skip_meta_init:
            return

        # 生成Repository类（去重基类避免重复继承）
        rep_bases = tuple(
            {getattr(base, "Repository") for base in self.__mro__ if hasattr(base, "Repository")}
        )
        rep_cls = type(
            "Repository",
            rep_bases,
            {
                "__module__": self.__module__,
                "__qualname__": f"{self.__qualname__}.Repository",
                "__persistent__": self,
            },
        )
        repository = rep_cls(_english_inflector.tableize(self.__qualname__))

        # 生成Ref类（去重基类避免重复继承）
        ref_bases = tuple(
            {getattr(base, "Ref") for base in self.__mro__ if hasattr(base, "Ref")}
        )
        ref_cls = type(
            "Ref",
            ref_bases,
            {
                "__module__": self.__module__,
                "__qualname__": f"{self.__qualname__}.Ref",
                "__persistent__": self,
                "__repository__": repository,
            },
        )

        setattr(self, "Repository", rep_cls)
        setattr(self, "Ref", ref_cls)
        setattr(self, "__repository__", repository)

针对Pydantic v1 #

仅需修改ModelMetaclass的导入路径：

from pydantic.main import ModelMetaclass
# 其余代码与v2版本一致

步骤3：验证修改效果 #

重新运行Vehicle实例化代码：

vehicles = [Vehicle(
    loadLimits=vehicle["loadLimits"],
    startLocation=Location(**vehicle["startLocation"]),
    endLocation=Location(**vehicle["endLocation"])
) for vehicle in json_data_vehicles]

此时Pydantic的验证器会正常生成并调用，不会再出现参数不匹配的错误。

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