如何禁止子类重写Pydantic BaseModel的指定字段？

要实现禁止子类重写父类特定字段的需求，同时保留BaseModel的验证和序列化功能，可以通过重写父类的__init_subclass__方法来实现字段检查，具体方案如下：

实现代码 #

from typing import Optional
from pydantic import BaseModel, Field

class TechData(BaseModel):
    id: Optional[int] = Field(default=None, alias='_id')

    def __init_subclass__(cls, **kwargs):
        super().__init_subclass__(**kwargs)
        # 检测子类是否重写了受保护的id字段
        if 'id' in cls.__annotations__ or 'id' in cls.model_fields:
            raise TypeError(f"子类 {cls.__name__} 不允许重写 'id' 字段")

# 测试：定义子类重写id会直接报错
class Child(TechData):
    id: Optional[int]  # 执行到这里会抛出 TypeError

方案说明 #

• 核心原理：__init_subclass__是Python的特殊方法，子类被定义时会自动触发执行。我们在这里检查子类的注解集合（__annotations__）和Pydantic自动生成的字段字典（model_fields），一旦发现子类声明了受保护的id字段，就直接抛出错误终止子类定义。
• 保留原有功能：该方案完全不影响BaseModel的字段验证、序列化/反序列化能力，父类的id字段依然可以正常使用别名、默认值等Pydantic特性。

为什么@property方案行不通 #

你之前尝试的@final+@property方式在BaseModel里报错，是因为id这个名称和Pydantic BaseModel内部的属性/方法命名冲突了——BaseModel的内部逻辑会对类属性和字段做特殊处理，id属于需要避开的敏感命名，因此这种方式不适用于Pydantic模型。

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