FastAPI同一路由绑定多请求方法失效问题求助

在FastAPI中使用Router时，为同一路由/test/route/{arg_test}/分别通过@router.get()和@router.post()绑定了不同处理函数，但调用requests.post()请求该路由时，系统提示需要传入GET方法所需的agr_2_test参数，出现POST请求被误识别为GET请求的现象。需保留两种装饰器的独立逻辑，不通过@router.route()合并处理，实现同一路由同时处理GET和POST请求。

相关代码示例 #

main.py #

from fastapi import FastAPI
from app.routers import test

app = FastAPI()

app.include_router(test.router)

if __name__ == "__main__":
    uvicorn.run("main:app", host="...", port=...)

Router文件（app/routers/test.py） #

from fastapi import APIRouter, Depends, UploadFile, File, HTTPException, Response, status

router = APIRouter(
    prefix="/test",
    tags=["test"],
    responses={404: {"description": "Not found"}},
)

@router.get("/route/{arg_test}/")
def get_function(arg_test:str, agr_2_test:int):
    # do something
    pass

@router.post("/route/{arg_test}/")
def post_function(arg_test:str, json_data:dict):
    # do something
    pass

测试请求代码 #

import requests

data = {"test_attribute":"test"}

requests.post(f"{url_fastapi}/route/{arg_test}/", json=data)

问题原因 #

1. POST参数声明错误：post_function中的json_data:dict未通过FastAPI的Body装饰器或Pydantic模型声明，FastAPI会将其视为必填查询参数。由于POST请求仅通过JSON请求体传递数据，未携带该查询参数，FastAPI返回的错误信息会包含同一路由下所有方法的必填参数（包括GET的agr_2_test），造成“POST被识别为GET”的错觉。
2. 请求URL不匹配：Router设置了prefix="/test"，因此完整路由应为/test/route/{arg_test}/，但测试代码中的URL缺少/test前缀，会导致请求路由不匹配，触发异常。

解决方案 #

1. 修正POST请求体参数声明 #

方案一：使用Body装饰器直接接收JSON

修改Router文件中的post_function：

from fastapi import APIRouter, Body  # 新增Body导入

# ... 其他代码保持不变

@router.post("/route/{arg_test}/")
def post_function(arg_test:str, json_data:dict = Body(...)):
    # do something
    pass

方案二：使用Pydantic模型（推荐复杂场景）

通过Pydantic模型定义请求体结构，更利于数据校验和类型提示：

from fastapi import APIRouter
from pydantic import BaseModel  # 新增BaseModel导入

# ... 其他代码保持不变

class RequestBody(BaseModel):
    test_attribute: str

@router.post("/route/{arg_test}/")
def post_function(arg_test:str, json_data: RequestBody):
    # 可通过json_data.test_attribute访问字段
    pass

2. 修正测试请求URL #

确保请求URL包含Router的/test前缀：

import requests

data = {"test_attribute":"test"}

# 新增/test前缀
requests.post(f"{url_fastapi}/test/route/{arg_test}/", json=data)

验证效果 #

修改完成后，POST请求会正确匹配post_function，接收JSON请求体中的数据，不再提示需要GET方法的agr_2_test参数，GET请求仍可正常匹配get_function并要求传入agr_2_test查询参数。

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