Bruno项目中Multipart表单数据发送问题的分析与解决

问题背景

在Bruno项目的最新版本1.39.1中，用户报告了一个关于Multipart表单数据发送异常的问题。该问题主要影响Windows 11系统用户，表现为Multipart表单数据未能按照预期格式发送，导致API请求失败。

问题现象

用户在使用Bruno发送Multipart表单请求时，发现实际发送的数据结构与标准Multipart格式存在显著差异。具体表现为：

1. 请求体被转换为一个包含额外元数据的JSON数组结构，而非标准的Multipart格式
2. 每个表单字段都自动添加了contentType、text、uid和enabled等非预期的元数据字段
3. 文件上传字段的值被错误地封装为数组形式

技术分析

标准的Multipart/form-data请求应包含以下特征：

• 明确的Content-Type头部，包含boundary标识符
• 每个表单字段以boundary分隔
• 每个字段包含Content-Disposition头部指定字段名
• 文件字段包含filename和Content-Type信息

而Bruno在此版本中出现了以下异常行为：

1. 头部缺失问题：未自动添加Content-Type: multipart/form-data头部，导致服务器无法正确解析请求体
2. 数据封装问题：将表单数据封装为包含元数据的JSON结构，而非原始表单数据
3. 文件处理问题：文件路径被错误地封装为数组形式

解决方案

经过测试验证，该问题可通过以下方式解决：

1. 手动添加Content-Type头部：在请求头中明确指定Content-Type: multipart/form-data，Bruno将自动生成正确的boundary并格式化请求体
2. 检查版本兼容性：确认使用Bruno 1.39.1版本，该版本已修复自动添加Content-Type头部的功能

相关问题的延伸发现

在调查过程中，还发现了一个相关的边界情况问题：

• 当使用@file()标记但未实际选择文件时，Bruno仍会计算文件大小并生成boundary
• 这种行为可能导致某些API接口报错，因为服务器期望接收文件但实际未收到

这个问题已被单独记录并将在后续版本中修复，解决方案将包括对空文件字段的特殊处理逻辑。

最佳实践建议

为避免类似问题，建议Bruno用户：

1. 始终检查请求头部是否包含正确的Content-Type
2. 对于文件上传接口，确保实际选择了文件或完全移除文件字段
3. 定期更新到最新版本以获取问题修复和功能改进

总结

Multipart表单数据处理是API测试工具的核心功能之一。Bruno团队已确认并修复了相关问题，展示了项目对用户反馈的快速响应能力。用户只需确保使用最新版本并遵循正确的表单数据格式规范，即可避免此类问题的发生。