FastAPI中如何在Traceback中显示Pydantic字段验证错误详情

核心问题 #

你当前手动抛出ResponseValidationError的方式错误，直接传入异常类而非实例，导致无法携带具体的字段验证错误信息。FastAPI默认在响应序列化失败时会自动抛出包含完整错误详情的异常，无需手动空抛。

具体解决方案 #

1. 移除无效的手动抛异常代码 #

删掉你当前这段错误的抛异常代码：

raise ResponseValidationError(
    fastapi.exceptions.ResponseValidationError
)

FastAPI会在响应模型验证失败时自动触发包含详细错误的ValidationError，无需手动干预。

2. 开启开发环境调试模式 #

启动FastAPI应用时设置debug=True，控制台会输出完整的Traceback和字段错误详情：

from fastapi import FastAPI

app = FastAPI(debug=True)

调试模式下，响应验证失败时你会看到类似你期望的详细错误栈，包含每个字段的错误类型和描述。

3. 自定义异常处理器（可选） #

如果需要自定义响应格式但保留错误详情，可重写异常处理器：

from fastapi import FastAPI, Request
from fastapi.responses import JSONResponse
from fastapi.exceptions import ResponseValidationError

app = FastAPI()

@app.exception_handler(ResponseValidationError)
async def validation_exception_handler(request: Request, exc: ResponseValidationError):
    # exc.errors() 包含所有字段的验证错误详情
    return JSONResponse(
        status_code=422,
        content={"detail": exc.errors(), "request_body": exc.body}
    )

此时控制台仍会输出包含完整Pydantic错误信息的Traceback。

4. 修正Pydantic模型结构 #

你的PostOutTEST模型存在结构问题：继承PostBase后又定义Post: PostBase字段，会导致响应数据匹配失败。根据数据库返回的结构调整模型：
如果数据库返回的是扁平结构（包含Post字段和votes）：

from pydantic import BaseModel, Optional

class PostBase(BaseModel):
    title: str
    content: str
    published: Optional[bool] = True

    class Config:
        from_attributes = True

class PostOutTEST(PostBase):
    votes: int

    class Config:
        from_attributes = True

如果数据库返回的是嵌套结构（包含post对象和votes）：

class PostOutTEST(BaseModel):
    post: PostBase
    votes: int

    class Config:
        from_attributes = True

模型结构正确后，验证错误信息会更精准，便于定位问题。

预期Traceback效果 #

调整后，响应验证失败时控制台会输出类似如下的详细错误：

in serialize_response
raise ValidationError(errors, field.type_)
pydantic.error_wrappers.ValidationError: 3 validation errors for PostOutTEST
response -> title
field required (type=value_error.missing)
response -> content
field required (type=value_error.missing)
response -> votes
field required (type=value_error.missing)

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