You need to enable JavaScript to run this app. 使用Python requests向FastAPI服务上传文件返回422错误的问题排查
优惠活动
大模型
产品
解决方案
定价
更多

使用Python requests向FastAPI服务上传文件返回422错误的问题排查

问题根因

两边文件上传的Multipart表单字段名不匹配,导致服务端无法识别到上传的文件参数。你当前环境已经安装了python-multipart依赖,不存在FastAPI解析Multipart表单的依赖缺失问题,可以直接排除这类常见报错诱因:

  • FastAPI 声明UploadFile/File参数时,默认会把「函数定义的参数名」作为要接收的Multipart表单字段名。当前服务端定义的参数名为my_file,仅会匹配表单字段名为my_file的文件内容。
  • 客户端通过requests上传时,传递的表单字段名为file,和服务端要求的字段名不一致,FastAPI检索不到对应参数就抛出了422字段缺失错误。

注:错误提示里的loc: ['query', 'my_file']是FastAPI匹配不到表单字段时的兜底定位提示,不代表参数是从URL query string获取的。

修正方案

两种方式二选一即可,无需同时修改:

方案1:调整客户端字段名匹配服务端定义

将客户端上传字典的key从file修改为服务端要求的my_file:

import requests

files = {'my_file': ('foo.txt', open('./foo.txt', 'rb'))}
response = requests.post('http://127.0.0.1:8000/file', files=files)
print(response)
print(response.json())

方案2:调整服务端参数名匹配客户端上传

将服务端函数的参数名从my_file修改为客户端上传使用的file:

from fastapi import FastAPI, File, UploadFile
import uvicorn

app = FastAPI()

@app.post('/file')
def _file_upload(file: UploadFile = File(...)):
    print(f"接收文件成功,文件名:{file.filename}")

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

实践优化:客户端上传文件时推荐使用上下文管理器打开文件,避免文件句柄未正常释放的问题,参考写法:

import requests

with open('./foo.txt', 'rb') as upload_file:
    files = {'my_file': ('foo.txt', upload_file)}
    response = requests.post('http://127.0.0.1:8000/file', files=files)

内容的提问来源于stack exchange,提问作者prometheanSun

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.15 00:45:01