FastAPI中DELETE接口无法正常工作的问题排查

问题场景 #

需要给FastAPI的DELETE接口传入两个参数做验证：字符串类型的id（路径参数）和ISO8601格式的DateTime类型date（查询参数），但接口始终返回400验证错误，无法正常获取并返回参数。

错误原因拆解 #

你的代码存在三个核心问题：

1. 参数绑定逻辑错误：你用DeleteInModel接收date参数，但该模型包含id和date两个字段，而实际请求是通过URL查询参数传递单个date值。FastAPI会将date: DeleteInModel解析为请求体参数，但DELETE请求通常不携带请求体，直接导致参数匹配失败。
2. 类型定义矛盾：DeleteInModel里的id被定义为int类型，但接口的路径参数id是str类型，类型不匹配触发验证错误。
3. 异常处理器屏蔽关键信息：自定义的RequestValidationError处理器只返回通用提示，看不到具体哪项参数验证失败，无法快速定位问题。

修复方案 #

1. 直接声明参数类型 #

无需额外的Pydantic模型，直接在接口函数里声明路径参数和查询参数：

• 路径参数id用Path()声明为str类型
• 查询参数date用Query()声明为datetime类型，FastAPI会自动验证ISO8601格式的时间字符串

2. 自定义返回格式（可选） #

如果需要将返回的datetime转换为指定的ISO8601格式（带Z后缀），可以在返回时手动调用格式化函数处理。

3. 优化异常处理器（可选） #

调试阶段可以暂时注释自定义的RequestValidationError处理器，让FastAPI返回默认的详细错误信息；上线后再换回简化提示，也可以在处理器里添加错误详情方便排查。

修复后的完整代码 #

from fastapi import FastAPI, Path, Query, Request, status
from fastapi.responses import JSONResponse
from fastapi.exceptions import RequestValidationError
from datetime import datetime
import json

app = FastAPI()

# 可选：保留异常处理器并添加错误详情
@app.exception_handler(RequestValidationError)
async def validation_exception_handler(request: Request, exc: RequestValidationError):
    return JSONResponse(
        status_code=status.HTTP_400_BAD_REQUEST,
        content=json.dumps({
            'code': 400,
            'message': 'Validation Failed',
            'details': exc.errors()  # 添加错误详情，调试用
        })
    )

@app.exception_handler(404)
async def existance_exception_handler(request: Request, exc: Exception):
    return JSONResponse(
        status_code=status.HTTP_404_NOT_FOUND,
        content=json.dumps({'code': 404, 'message': 'Item not found'})
    )

# 自定义datetime格式化函数
def format_datetime(dt: datetime) -> str:
    return dt.strftime('%Y-%m-%dT%H:%M:%S.000Z')

@app.delete('/delete/{id}', status_code=status.HTTP_200_OK)
async def delete_import(
    id: str = Path(description="字符串类型的ID"),
    date: datetime = Query(description="ISO8601格式的日期时间")
):
    # 返回时格式化datetime
    return {'id': id, 'date': format_datetime(date)}

测试请求 #

使用你提供的请求地址即可正常访问：

localhost:8000/delete/элемент_1_5?date=2022-05-28T21:12:01.516Z

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