FastAPI查询Store接口配置Pydantic响应模型触发ValidationError求解

云原生阿岚

2026-10-4

问题解决方法

问题根源

你定义Store的SQLAlchemy模型时，items关联字段设置了lazy="dynamic"，这种配置下访问store.items返回的是SQLAlchemy的AppenderQuery查询对象，不是Pydantic预期的列表结构，所以触发类型校验报错。去掉response_model后FastAPI不会做强制类型转换，所以可以正常返回。

解决方案（任选一种即可）

方案1：修改关联的懒加载策略

直接修改Store模型中items字段的lazy参数，替换掉dynamic配置：

# 修改前
items = relationship("Item",lazy="dynamic",primaryjoin="Store.id == Item.store_id")
# 修改后，比如用默认的select加载，或者用joined预加载都可以
items = relationship("Item",lazy="select",primaryjoin="Store.id == Item.store_id")

这种方式最简单，适合不需要对store.items做二次动态查询的场景。

方案2：查询时主动预加载关联数据，保留dynamic配置

如果你需要保留lazy="dynamic"的动态查询能力，只需要在查询Store数据时主动加载items数据，让返回的是列表类型即可：

先导入预加载工具：

from sqlalchemy.orm import joinedload

修改你的StoreRepo.fetch_all和StoreRepo.fetch_by_name查询逻辑：

# fetch_all示例
def fetch_all(db: Session):
    return db.query(Store).options(joinedload(Store.items)).all()

# fetch_by_name示例
def fetch_by_name(db: Session, name: str):
    return db.query(Store).options(joinedload(Store.items)).filter(Store.name == name).first()

方案3：在Pydantic Schema中自定义字段校验

也可以在Store的Pydantic模型中加自定义字段逻辑，自动把Query对象转成列表：

from pydantic import validator

class Store(StoreBase):
    id: int
    items: List[Item] = []

    class Config:
        orm_mode = True

    @validator('items', pre=True)
    def convert_query_to_list(cls, v):
        if hasattr(v, 'all'):
            return v.all()
        return v