接口测试时如何上传文件（图片、安装包等）

在做接口测试时，针对需要上传文件（图片、安装包等）的 POST 请求，一般都是通过 HTTP 的 multipart/form-data 方式来传输。下面分别介绍在 Postman 和 Python（requests 库）里如何实现。

1. 选择请求方法和 URL

• Method 选 “POST”（或接口文档指定的方法）
• 在地址栏填入接口 URL

2. 设置 Body 为 form‑data

• 点击 “Body” 标签
• 选中 “form‑data” 选项

3. 新增字段并设置类型为 File

• 在 Key 列输入字段名（与后台约定一致）
• 下拉选择 “File”，Value 列会出现文件选择按钮

4. 如果还有其他普通文本参数，继续在 form‑data 中以 Text 类型添加即可。

5. 添加对应的请求参数，并发送请求

• 点击 “Send”
• 查看返回，确认文件是否上传成功

使用 requests 库发送 multipart/form-data 请求：

import requestsdef upload_file(api_url, params, file_paths):"""api_url: 接口地址params: dict, 普通表单字段file_paths: dict, 文件字段名 -> 本地文件路径"""# 构造 files 参数files = {}for field_name, path in file_paths.items():# 'rb' 以二进制模式打开文件files[field_name] = open(path, 'rb')try:response = requests.post(api_url, data=params, files=files)response.raise_for_status()  # 如果返回码不是200-399，会抛出异常return response.json()finally:# 关闭文件句柄for f in files.values():f.close()if __name__ == "__main__":api_url = "https://api.example.com/upload"params = {"username": "test_user","description": "这是一个测试上传"}file_paths = {"image": "path/to/logo.png","installer": "path/to/app.apk"}result = upload_file(api_url, params, file_paths)print("接口返回：", result)

• data=params：普通文本字段
• files=files：文件字段，requests 会自动将 Content-Type 设置为 multipart/form-data
• 调用时，只需将文件路径和字段名对应好即可

如果使用 pytest 进行自动化，可以这样写：

import pytest
import requests@pytest.fixture
def api_url():return "https://api.example.com/upload"@pytest.fixture
def common_params():return {"username": "pytest_user","description": "pytest 上传测试"}def test_upload(api_url, common_params):files = {"image": open("tests/data/logo.png", "rb"),"installer": open("tests/data/app.apk", "rb"),}resp = requests.post(api_url, data=common_params, files=files)for f in files.values(): f.close()assert resp.status_code == 200json_body = resp.json()# 根据接口文档断言assert json_body.get("success") is Trueassert "fileUrl" in json_body

• 用 pytest.fixture 分离公共配置
• 在测试函数里直接调用 requests.post
• 断言 HTTP 状态码和返回字段

• 超大文件：若文件非常大，考虑分片上传或流式上传，详见 requests 的 stream 机制。
• 自定义 Headers：如果需要授权（如 Bearer Token），可在请求中加入

  headers={"Authorization": "Bearer xxx"}

• 超时与重试：生产脚本中建议加上 timeout=(连接超时, 读取超时)，并结合 requests.adapters.HTTPAdapter 实现重试。