FastAPI中如何合并Pydantic与SQLite数据库模型为单个类？

你遇到的是FastAPI+SQLAlchemy栈非常常见的重复代码问题，有两种成熟的处理方案，按需选择即可：

1. 零依赖快速改造：彻底删除逐行属性拷贝逻辑 #

不需要调整现有模型结构，直接利用Pydantic自带的序列化方法实现批量属性赋值，后续新增字段完全不用修改CRUD逻辑。

改造后的接口代码 #

@app.post("/", response_model=models.Component)
def create_component(component: Component, db: Session = Depends(get_db)):
    # Pydantic模型直接转字典拆包传入ORM构造函数，无需逐行赋值
    c = models.Component(**component.model_dump())
    db.add(c)
    db.commit()
    db.refresh(c) # 刷新获取数据库自动生成的id等字段
    return c

@app.put("/{component_id}", response_model=models.Component)
def update_component(component_id: int, component: Component, db: Session = Depends(get_db)):
    # 原代码漏了查询逻辑，补上
    c = db.query(models.Component).filter(models.Component.id == component_id).first()
    if not c:
        raise HTTPException(status_code=404, detail="组件不存在")
    # 遍历字段批量赋值
    for field, val in component.model_dump().items():
        setattr(c, field, val)
    db.add(c)
    db.commit()
    db.refresh(c)
    return c

• 如果使用Pydantic V1版本，将代码里的model_dump()替换为dict()即可
• 如果两边存在不需要同步的异名字段，给model_dump()加exclude参数排除即可，写法为component.model_dump(exclude={"字段名"})

2. 彻底消除重复模型定义：单模型同时承担ORM和数据校验能力 #

如果不想维护两个字段高度重合的Component类，可以用SQLModel（FastAPI官方作者维护的库，原生兼容现有FastAPI、SQLAlchemy栈），一个类就能同时实现数据库表定义、Pydantic数据校验的能力，从根源上避免重复代码。

改造后的models.py #

from sqlmodel import SQLModel, Field
from typing import Optional

# 抽公共字段基类，所有模型共享字段定义
class ComponentBase(SQLModel):
    name: str = Field(min_length=1)
    author: str = Field(min_length=1, max_length=100)
    description: str = Field(min_length=1, max_length=100)

# 数据库表模型，新增主键id，标记table=True即为ORM模型
class Component(ComponentBase, table=True):
    id: Optional[int] = Field(default=None, primary_key=True)

改造后的接口代码 #

# 直接导入models里的模型即可，不需要在main.py里重复定义Component Pydantic模型
@app.post("/", response_model=Component)
def create_component(component: ComponentBase, db: Session = Depends(get_db)):
    db_component = Component.model_validate(component)
    db.add(db_component)
    db.commit()
    db.refresh(db_component)
    return db_component

后续新增字段只需要在ComponentBase里添加一次，所有子类、CRUD逻辑会自动适配，完全不需要写重复的字段定义和赋值代码。如果后续需要区分创建请求、更新请求、响应返回的字段差异，直接继承基类扩展即可，灵活性很高。

不建议尝试用多继承强行让一个普通类同时兼容SQLAlchemy和Pydantic，两边的元类逻辑冲突很多，调试成本远高于收益。

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