FastAPI之单参数接口

定义了一个单参数的接口，发现咋请求都会报错422，接口定义和请求如下：

@app.post("/test")
def sample(param: str=Body(...)):
    ...

data = {'param': 'AAA'}
response = requests.post(url, json=data)

错误信息为 {'detail': [{'loc': ['body'], 'msg': 'str type expected', 'type': 'type_error.str'}]}。按照以往经验，一直这么用，不可能会出错啊，捣鼓了半天，才发现单参数接口和多参数接口有区别。

原因：

‌在FastAPI中，当接口只有一个参数时，该参数不会被视为整个请求体。‌这是因为FastAPI在处理请求体时，会根据参数的数量和类型来判断如何解析请求体。当接口只有一个参数且遵循JSON传参规则时，FastAPI会将该参数作为一个字符串处理，而不是作为一个对象处理‌。

解决方案：

方案一：明确告诉它将其视为整个请求体。通过使用 Body 装饰器并设置 embed=True 参数来实现，如下：

@app.post("/test")
def sample(param: str=Body(..., embed=True)):
    ...

 方案二：使用 Pydantic 模型，如下：

from pydantic import BaseModel

class Item(BaseModel):
    param: str

@app.post("/test")
def sample(item: Item):
    ...