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

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

一、Postman 中上传文件

1. 选择请求方法和 URL

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

2. 设置 Body 为 form‑data
点击 "Body" 标签
选中 "form‑data" 选项

3. 新增字段并设置类型为 File
在 Key 列输入字段名（与后台约定一致）
下拉选择 "File"，Value 列会出现文件选择按钮
4. 如果还有其他普通文本参数，继续在 form‑data 中以 Text 类型添加即可。

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

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

二、Python（requests）自动化脚本

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

python 复制代码

import requests

def 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/unittest）中集成

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

python 复制代码

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 == 200
    json_body = resp.json()
    # 根据接口文档断言
    assert json_body.get("success") is True
    assert "fileUrl" in json_body

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

注意点

超大文件 ：若文件非常大，考虑分片上传或流式上传，详见 requests 的 stream 机制。
自定义 Headers ：如果需要授权（如 Bearer Token），可在请求中加入
python 复制代码
```
headers={"Authorization": "Bearer xxx"}
```
超时与重试：生产脚本中建议加上 timeout=(连接超时, 读取超时)，并结合 requests.adapters.HTTPAdapter 实现重试。