FastAPI使用ShowUser作为响应模型出现ValidationError问题求助

错误原因 #

触发ValidationError的核心问题是返回数据结构与response_model不匹配：

• 接口指定response_model=ShowUser，要求返回的对象必须包含username、name、lastname、email字段
• 但你实际返回的是{"User": user}，外层多了一层User键，导致Pydantic无法在顶层找到ShowUser所需字段，因此抛出字段缺失的错误。

修复方案 #

方案1：直接返回ORM对象（推荐）

你的ShowUser已开启orm_mode=True，可以直接兼容SQLAlchemy的ORM实例，去掉外层字典包装，直接返回查询到的user即可：

@router.get('/{user_id}', response_model=ShowUser)
def get_user(user_id: int, db: Session = Depends(get_db)):
    user = db.query(models.User).filter(models.User.id == user_id).first()
    if not user:
        raise HTTPException(status_code=404, detail="User not found")
    return user  # 直接返回user对象

FastAPI会自动通过ShowUser序列化ORM对象，只返回你定义的字段，同时避免结构不匹配问题。

方案2：保留User键结构（按需使用）

如果业务必须返回{"User": ...}格式，需要修改response_model为包含ShowUser的父模型：

# 在schemas.py中新增
class UserResponse(BaseModel):
    User: ShowUser

# 修改接口的response_model
@router.get('/{user_id}', response_model=UserResponse)
def get_user(user_id: int, db: Session = Depends(get_db)):
    user = db.query(models.User).filter(models.User.id == user_id).first()
    if not user:
        raise HTTPException(status_code=404, detail="User not found")
    return {"User": user}

额外优化：错误处理规范 #

当前错误返回{"Error": "User not found"}不符合response_model结构，建议使用FastAPI内置的HTTPException返回标准错误响应，更符合RESTful规范：

from fastapi import HTTPException

# ...

if not user:
    raise HTTPException(status_code=404, detail="User not found")

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