Pydantic模型中schema字段与父类属性冲突，无法重命名如何解决？

问题本质是Pydantic的BaseModel自带一个schema()方法，你定义的字段名schema和这个方法重名了。直接用alias='schema'没用是因为没改内部字段名——只是加了别名，内部字段名还是schema，依然会遮蔽父类的属性。

正确的做法是修改内部字段名，同时保留API要求的schema别名，具体步骤如下：

• 把模型中的schema字段名改成不冲突的名称（比如_schema）
• 用Field(alias='schema')指定外部API使用的别名
• 在模型的model_config里设置populate_by_name = True，确保Pydantic能同时识别别名和内部字段名

修改后的代码示例：

from pydantic import BaseModel, Field
from typing import List

class SnowflakeTable(BaseModel):
    database: str
    _schema: str = Field(alias='schema')
    table: str
    table_schema: List[SnowflakeColumn]

    model_config = {
        'populate_by_name': True
    }

class DataContract(BaseModel):
    _schema: List[OpenmetadataColumn] = Field(alias='schema')

    model_config = {
        'populate_by_name': True
    }

这样修改后，API请求和响应中依然可以用schema作为字段名，而内部代码里使用_schema来访问该字段，既满足了API规则，又避免了和BaseModel的schema()方法冲突。FastAPI会自动处理别名，返回的JSON也会保持schema字段名。

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