Postman一次上传多个文件需Key名完全一致（如files）且后端用List接收；错误命名（如files[0]）或使用MultipartFile[]会导致400/空列表；需调大multipart限制并确认form-data模式。
Postman 一次上传多个文件完全可行，关键在于 form-data 中的 Key 命名和后端接收方式必须匹配 —— 否则只会收到第一个文件，或直接报 400 错误。
Key 必须用相同名称，不能带 [] 后缀
很多用户照着前端 JS 写法习惯性填 files[] 或 file[]，这是错的。Postman 的 form-data 不解析方括号，它只看字段名是否一致：
- ✅ 正确：所有文件行都填同一个
Key，比如file或files - ❌ 错误：
files[0]、files[1]这种写法后端收不到数组，Spring Boot 会当成多个独立参数处理 - ⚠️ 注意：即使你手动 Bulk Edit 输入多行
files:C:\a.jpg和files:C:\b.png，也必须确保 Key 完全一致（不含空格、大小写敏感）
List 是 Spring Boot 接收多文件的唯一可靠方式
后端用 MultipartFile[] 看似合理，但实际在某些 Spring 版本或容器（如 Tomcat 9+）下会丢文件或抛 ArrayIndexOutOfBoundsException。必须用泛型列表：
- ✅ 接口定义应为：
@RequestParam("files") Listfiles - ❌ 避免：
@RequestParam("files") MultipartFile[] files（尤其在 Spring Boot 3.x + Jakarta EE 9+ 环境下更不稳定） - ? 补充：如果同时传文本参数（如
category），它们和文件共存于同一form-data，无需额外设置Content-Type头 —— Postman 会自动生成正确的boundary
上传失败常见错误及对应解法
看到 400、413 或空文件列表？大概率是这几个点卡住了：
Postman Mac版
下载
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
-
400 Bad Request：检查 Key 名是否拼错，或后端@RequestParam的value值与 Postman 中的 Key 不一致（比如 Postman 填了file，后端写成@RequestParam("files")） -
413 Payload Too Large：Spring Boot 默认单文件限 1MB、总请求限 10MB。需在application.properties显式调大：spring.servlet.multipart.max-file-size=50MB和spring.servlet.multipart.max-request-size=100MB - 后端
files列表为空：确认 Postman Body 确实选的是form-data（不是raw或x-www-form-urlencoded），且每行 Value 类型都设为File（不是Text）
批量选文件的两种实操路径
别拖拽 100 次。真要高效，就用下面任一方式：
- ✅ Ctrl/Cmd 多选：点击
Select Files后，在文件对话框中按住Ctrl（Windows/Linux）或Cmd（macOS），再点选多个文件 —— 所有文件自动塞进同一个 Key 下 - ✅ Bulk Edit 手动粘贴路径：点击 Key 右侧下拉 →
Bulk Edit→ 按行输入：files:/path/to/a.jpg、files:/path/to/b.pdf（注意路径分隔符用正斜杠 /，Windows 也适用） - ⚠️ 注意：Bulk Edit 模式下，Postman 不校验文件是否存在，路径错或权限不足会导致后端读取时抛
IOException
真正容易被忽略的是：Postman 在 Bulk Edit 模式下不会实时显示已选文件数量，也不会校验路径有效性 —— 发送前务必点回 Key-Value Edit 确认行数，再看响应体里有没有 files.size() 对应的日志输出。
