FastApi中奇怪的405错误Method Not Allowed

在使用 FastApi 测试接口时，在 swagger 中能正常请求的接口在客户端请求时报错 {"code": 405, "status": "error", "message": "Method Not Allowed"} ，来看下是怎么回事。

在 skill.py 中有接口：

router = APIRouter()
@router.post("/", response_model=QueryResponse, summary='技能查询')
async def get_skill() -> Any:
    """
    技能答案查询
    """
    return QueryResponse(message='')

接口在 swagger 接口文档中可以很正常的访问，正常返回，但是在前端对接的平台上却返回 405 错误：

{
    "code":405,
    "status":"error",
    "message":"Method Not Allowed"
}

从提示信息很容易误判是请求方的请求方法问题导致的，接口是 POST 请求，但是实际上，客户端确实是 POST 请求没错，这很奇怪。

仔细查看失败请求的 nginx 访问日志：

8.8.8.8 - - [10/Jul/2023:15:53:08 +0800] "POST /api/skill HTTP/1.1" 307 0 "-" "python-requests/2.30.0" "-"
8.8.8.8 - - [10/Jul/2023:15:53:08 +0800] "POST /api/skill/ HTTP/1.1" 301 169 "-" "python-requests/2.30.0" "-"
8.8.8.8 - - [10/Jul/2023:15:53:08 +0800] "GET /api/skill/ HTTP/1.1" 405 60 "-" "python-requests/2.30.0" "-"

发现原始请求地址是： POST /api/skill ，被307转到 POST /api/skill/ 然后再被301转到了 GET /api/skill/ 这时候就返回405了，我们只需要将客户端的请求地址从 /api/skill 修改为 /api/skill/ 就可以正常访问了。