python - FastAPI 单参数正文导致 Pydantic 验证错误

Question

我有一个 POST FastAPI 方法。我不想构造一个类也不想查询字符串。所以，我决定应用Body()方法。

@app.post("/test-single-int")
async def test_single_int(
    t: int = Body(...)
):
    pass

这是请求

POST http://localhost:8000/test-single-int/

{
  "t": 10
}

这就是回应

HTTP/1.1 422 Unprocessable Entity
date: Fri, 22 May 2020 10:00:16 GMT
server: uvicorn
content-length: 83
content-type: application/json
connection: close

{
  "detail": [
    {
      "loc": [
        "body",
        "s"
      ],
      "msg": "str type expected",
      "type": "type_error.str"
    }
  ]
}

但是，在尝试了许多样本后，我发现如果我有多个样本，它们不会出错Body()。例如，

@app.post("/test-multi-mix")
async def test_multi_param(
    s: str = Body(...),
    t: int = Body(...),
):
    pass

要求

POST http://localhost:8000/test-multi-mix/

{
  "s": "test",
  "t": 10
}

回复

HTTP/1.1 200 OK
date: Fri, 22 May 2020 10:16:12 GMT
server: uvicorn
content-length: 4
content-type: application/json
connection: close

null

有人对我的实施有任何想法吗？有错吗？这不是最佳实践吗？或者它是一个错误？

Answer 1

这不是一个错误，它是 Body 的行为方式，它存在于“扩展”请求参数如何文档概述：

class Item(BaseModel):
    name: str

class User(BaseModel):
    username: str
    full_name: str = None


@app.put("/items/{item_id}")
async def update_item(
    *,
    item_id: int,
    item: Item,
    user: User,
    importance: int = Body(..., gt=0),
    q: str = None
):
    pass

此视图的有效请求正文为：

{
    "item": {
        "name": "Foo",
        "tax": 3.2
    },
    "user": {
        "username": "dave",
        "full_name": "Dave Grohl"
    },
    "importance": 5
}

如果你真的想单独使用 Body ，你必须指定embed=True，这个按预期工作：

@app.put("/items/{item_id}")
async def update_item(
    *,
    item_id:int,
    importance: int = Body(..., gt=0, embed=True),
    q: str = None
):
    pass

Answer 2

使用 FastApi 从正文中获取任何数据：

@app.post("/someurl")
async def someMethod(body: dict):
    return body