使用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
相关产品推荐
相关产品推荐

