怎么在Python中使用pytest测试文件上传接口

星丽吖_4762

星丽吖_4762

2026-10-19

230人浏览

原创

pytest本身不处理http请求,正确做法是用requests或框架测试客户端(如fastapi的testclient)的files参数传元组,如{"file": ("f.jpg", open("f.jpg", "rb"), "image/jpeg")},避免手动构造multipart body。

怎么在python中使用pytest测试文件上传接口

pytest怎么模拟multipart/form-data文件上传

直接用 requests.post 发原始二进制数据容易出错,关键在于构造符合 RFC 7578 的 multipart body —— pytest 本身不处理 HTTP 请求,真正干活的是 requests 或测试客户端(如 FastAPI 的 TestClient、Flask 的 test_client),pytest 只负责组织断言和 fixture。

常见错误现象:400 Bad Request 或后端解析出空文件,多半是 files 参数格式不对,或没传 Content-Type(其实不用手动设,requests 会自动加带 boundary 的 multipart/form-data)。

  • 正确写法:用 files 参数传元组,格式为 {"file": ("filename.jpg", file_obj, "image/jpeg")}
  • 如果读取本地文件,用 open("test.jpg", "rb"),别用文本模式
  • 内存中构造小文件可用 io.BytesIO(b"fake image data"),避免依赖磁盘
  • 多文件上传时,files 可传列表,如 [("files", f1), ("files", f2)](注意字段名一致)

FastAPI/Flask测试中如何用TestClient发文件

Web 框架的测试客户端比裸 requests 更可靠,它绕过网络栈,直接调用路由函数,能捕获更清晰的错误堆栈。

使用场景:你用的是 FastAPI?Flask?还是 Django?对应客户端初始化方式不同,但发文件逻辑高度一致。

  • FastAPI:from fastapi.testclient import TestClient,实例化后调用 client.post("/upload", files=...)
  • Flask:app.test_client(),同样支持 .post(..., files=...)
  • Django 要用 django.test.Client().post(..., data=..., format="multipart"),且需确保视图用了 request.FILES
  • 注意:FastAPI 的 UploadFile 参数必须标注类型提示,否则测试客户端无法正确绑定

怎么测文件大小超限、类型不匹配等边界情况

光测“上传成功”没意义。真实接口必有校验逻辑,比如 max_file_size=5*1024*1024 或只允许 ["png", "jpg"],这些必须在测试里覆盖。

361SCAN security check your skill python scripts
361SCAN security check your skill python scripts

扫描并分析已安装技能,用于查看指定技能目录的名称、描述和详情,或列出所有已安装的技能。

下载

性能影响:用大文件做测试会拖慢 CI,建议用 io.BytesIO 构造刚好超限的假数据(比如 5_000_001 字节),而不是真写一个 5MB 文件到磁盘。

  • 测超限:构造 BytesIO(b"x" * (max_size + 1)),检查返回 413 Payload Too Large 或自定义错误码
  • 测非法类型:传 ("evil.exe", b"...", "application/x-msdownload"),验证是否被拒绝(状态码或响应体含 "invalid type")
  • 测空文件:("empty.txt", b"", "text/plain"),看后端是否判空并返回 400
  • 别忘了测 filename 为空或含路径遍历字符(如 "../etc/passwd"),验证服务端是否做了清理

为什么测试里总遇到UnicodeDecodeError或Missing boundary

这基本等于你误把字符串当二进制用了。multipart body 必须是 bytes,而 Python 3 默认字符串是 Unicode,混用就会炸。

容易踩的坑:

  • 用 open("f.txt").read()(文本模式)代替 open("f.txt", "rb").read() → 报 UnicodeDecodeError
  • 手动拼接 multipart body 字符串(比如用 f"""--{boundary}...""")→ 缺少 CRLF、boundary 不匹配 → Missing boundary 或解析失败
  • 用 json.dumps(...) 当请求体,却还传 files=... → requests 会忽略 files,因为 json 和 files 互斥
  • 忘记关闭 BytesIO 或文件句柄 → 小概率导致后续测试读不到内容(尤其 Windows)

边界 case 的构造比主流程更费神,尤其是 filename 编码、空字节、超长名这些,实际攻防中常被利用,但测试里最容易漏掉。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1751

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4544

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1729

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

26797

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3247

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3267

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1183

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

596

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2523

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习