如何在Postman中简化含byte[]参数的RESTful API测试？

方案1：修改接口支持multipart/form-data（推荐） #

直接调整接口接收IFormFile类型的文件参数，搭配其他表单参数，这是文件上传场景的标准做法，Postman测试也最直观。

示例代码 #

[HttpPost("process-file")]
public async Task<IActionResult> ProcessFile([FromForm] FileProcessingRequest request)
{
    // 将IFormFile转换为byte[]
    using var memoryStream = new MemoryStream();
    await request.UploadedFile.CopyToAsync(memoryStream);
    byte[] fileBytes = memoryStream.ToArray();

    // 此处添加你的文件处理逻辑，同时可直接使用request.OtherRequiredParam等其他参数
    return Ok(new { Message = "文件处理完成", FileSize = fileBytes.Length });
}

// 定义请求模型
public class FileProcessingRequest
{
    public IFormFile UploadedFile { get; set; }
    public string OtherRequiredParam { get; set; }
    // 可添加更多业务参数
}

Postman测试步骤 #

1. 请求方法选POST，输入接口地址
2. Body标签下选择form-data
3. 添加参数：
   • 键名填UploadedFile，类型选File，点击右侧选择文件
   • 添加其他参数（如OtherRequiredParam），类型选Text并填写对应值
4. 发送请求即可

方案2：用Base64编码替代byte[]参数（兼容原有接口逻辑） #

ASP.NET的JSON序列化器支持自动将Base64字符串解析为byte[]，无需修改核心处理逻辑，仅需调整请求体的传参方式。

接口模型（无需修改） #

public class FileRequest
{
    public byte[] FileBytes { get; set; }
    public string OtherParam { get; set; }
}

Postman自动生成Base64脚本 #

在Pre-request Script标签下添加以下代码：

// 读取Postman中已添加的文件（需先在"Files" tab添加文件，变量名设为"targetFile"）
const targetFile = pm.request.files.get('targetFile');
if (targetFile) {
    const reader = new FileReader();
    reader.onload = function() {
        // 提取纯Base64字符串（去除"data:...;base64,"前缀）
        const base64Content = reader.result.split(',')[1];
        // 将Base64字符串存入环境变量
        pm.environment.set('fileBase64', base64Content);
    };
    reader.readAsDataURL(targetFile);
}

请求体配置 #

选择Body -> raw -> JSON，填入以下内容：

{
    "FileBytes": "{{fileBase64}}",
    "OtherParam": "你的业务参数值"
}

发送请求时，Postman会自动将文件转为Base64并填充到请求体中。

方案3：自动生成数字数组字符串（完全兼容原有byte[]参数） #

如果必须保留byte[]参数的数字数组传参方式，可通过Postman脚本自动生成数组字符串，避免手动操作。

Postman自动生成数组脚本 #

在Pre-request Script标签下添加：

const targetFile = pm.request.files.get('targetFile');
if (targetFile) {
    const reader = new FileReader();
    reader.onload = function() {
        const arrayBuffer = reader.result;
        const byteArray = new Uint8Array(arrayBuffer);
        // 转换为数字数组字符串
        const byteArrayStr = JSON.stringify(Array.from(byteArray));
        pm.environment.set('fileByteArray', byteArrayStr);
    };
    reader.readAsArrayBuffer(targetFile);
}

请求体配置 #

选择Body -> raw -> JSON，填入：

{
    "FileBytes": {{fileByteArray}},
    "OtherParam": "你的业务参数值"
}

注意这里{{fileByteArray}}不需要加引号，因为它本身就是数组格式的字符串。

内容的提问来源于stack exchange，提问作者misterbee180