FastAPI报value_error.missing但请求参数已存在的问题排查

常见原因 #

• 请求发送方式错误：用requests发POST时，误将json参数换成data参数，导致数据以表单形式发送，FastAPI无法解析为JSON格式，自然读不到字段。
• 路径参数与请求体混淆：接口路径中的student_id是路径参数，若代码里误将其和请求体字段混在一起处理，会引发字段识别异常。
• 模型字段不匹配：Student模型的字段拼写、大小写和请求payload里的不一致，或模型字段设置了特殊验证规则导致解析失败。
• 请求头缺失：未设置Content-Type: application/json请求头，FastAPI默认不会将非JSON格式的请求体解析为模型对象。

修正步骤 #

1. 修正requests请求代码 #

必须用json参数传递payload，而非data：

import requests

payload = {"name": "张三", "age": 20, "year": 2024}
response = requests.post("http://localhost:8000/create-student/123", json=payload)

2. 规范FastAPI接口代码 #

明确区分路径参数和请求体模型：

from fastapi import FastAPI
from pydantic import BaseModel

app = FastAPI()

class Student(BaseModel):
    name: str
    age: int
    year: int

@app.post("/create-student/{student_id}")
async def create_student(student_id: int, student: Student):
    return {"student_id": student_id, **student.dict()}

这里student_id是路径参数，student是请求体模型，二者要分开定义。

3. 核对模型与请求字段 #

确保Student模型里的name、age、year和请求payload里的字段完全一致，包括大小写。

4. 确认请求头（可选） #

虽然requests.post的json参数会自动添加Content-Type: application/json，但用其他工具发送请求时必须手动设置：

headers = {"Content-Type": "application/json"}
response = requests.post("http://localhost:8000/create-student/123", json=payload, headers=headers)

5. 调试请求内容 #

在接口中打印原始请求体，确认数据是否正常传到后端：

from fastapi import Request

@app.post("/create-student/{student_id}")
async def create_student(student_id: int, request: Request):
    raw_body = await request.body()
    print(raw_body)  # 查看原始请求内容
    student = await request.json()  # 手动解析JSON
    return {"student_id": student_id, "student": student}

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