Postman中form-data的Key名必须与后端@RequestParam或@RequestPart注解的值完全一致，包括大小写、下划线等，否则导致400或500错误；多文件上传需重复相同Key名且类型均为File，不可加下标或@符号；混合传参时须手动切换Value类型，避免覆盖；Key应使用小写字母+下划线，禁用空格、中文、特殊字符。
Postman里form-data的Key名必须和后端@RequestParam或@RequestPart一致
填错字段名是文件上传400或500错误的第一大原因。Spring Boot用@RequestParam("files")接收，Key就必须填files；若后端是@RequestPart("uploadFile")，Key就得是uploadFile。大小写、下划线、中英文冒号都必须完全匹配。
常见错误现象：Required request part 'files' is not present 或 Failed to parse multipart servlet request
- 不要在Key里加
@符号（那是旧版curl写法，Postman不认） - 不要把Key写成
file[]来模拟数组——Postman原生支持同名多值，直接填files，点两次Select Files选多个即可 - 如果后端要求区分文件类型（如
avatar和idCard），就分别建两个Key，类型都设为File，不能混用
多文件上传时Key名重复才有效，不是靠后缀或序号
Postman对同名Key的处理逻辑很直接：只要Key字符串完全相同，且类型都是File，它就会把所有选中的文件打包进同一个multipart/form-data part里。后端收到的就是一个MultipartFile[]或List<multipartfile></multipartfile>。
使用场景：用户一次上传3张证件照，后端接口定义为public ResponseEntity upload(@RequestParam("images") MultipartFile[] images)
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
- 在form-data里添加3行，Key全填
images，每行Value类型选File，各自点Select Files - 别写成
images[0]、images[1]——这会被当3个独立字段，后端收不到数组 - 如果只填了一个
images但点了“多选”上传多个文件，Postman只会取第一个，其余静默丢弃
混合传文件和文本参数时，Key名不能冲突，类型必须手动切换
form-data里所有字段共用一套Key命名空间。同一个Key既设成File又设成Text会覆盖，导致部分参数丢失。
例如后端需要@RequestParam("userId") String userId和@RequestParam("avatar") MultipartFile avatar，则：
- 第一行Key填
userId，类型保持默认Text，Value写12345 - 第二行Key填
avatar，必须手动把类型从Text点开改成File，再点Select Files - 如果忘了切类型，Postman会把
avatar当纯文本发过去，后端抛org.springframework.web.multipart.support.MissingServletRequestPartException - Content-Type头无需手动填
multipart/form-data——Postman自动加，并附带正确的boundary，手填反而可能出错
特殊字符或空格在Key名里会引发解析失败
虽然HTTP协议允许Key含空格或中文，但多数后端框架（尤其是Spring）默认只接受ASCII字母、数字、下划线和短横线。Key里出现用户头像、file name、file@v2这类写法，大概率触发Invalid boundary in multipart或直接400。
- 坚持用小写字母+下划线组合，如
user_avatar、cert_file - 避免使用点号（
.）、括号（()）、星号（*）、中文标点 - 不确定时，先看后端Swagger文档或Controller源码里的注解值，照抄最稳
最容易被忽略的是Key名大小写敏感性和前后空格——复制粘贴时容易带入不可见字符，建议手动敲一遍，别直接Ctrl+V。
