Postman用同一字段名上传多个文件完全可行，前提是前端用form-data模式、后端用MultipartFile[]或List接收；同名字段能传多文件因multipart/form-data协议允许多个同name part，Postman多选文件即生成多个对应part。
Postman 用同一个字段名上传多个文件，完全可行，但必须满足两个前提：前端表单用 form-data 模式、后端用数组或集合类型接收（如 MultipartFile[] 或 List<multipartfile></multipartfile>）。否则会只收到第一个文件，或直接报错。
为什么同名字段能传多文件？关键在 multipart/form-data 协议
HTTP 协议本身不禁止重复键名；multipart/form-data 的设计允许同一 name 出现多次，每次对应一个独立 part。Postman 在 form-data 模式下，对同一 Key 多次添加 File 类型值，就会生成多个带相同 name 的 part —— 这正是后端能拿到数组的前提。
常见错误现象：
- 只收到一个文件（后端用了
@RequestParam MultipartFile file单对象接收） - 返回 400 或 415 错误（
Content-Type被手动设为multipart/form-data且带了固定 boundary） - Postman 界面里 Key 显示为
files[]，但后端收不到 —— 实际上[]是 PHP/JS 习惯写法，Spring Boot 不需要也不识别它，留空即可
Postman 正确配置：Key 不加中括号，Value 选 File 后点「Select Files」多选
Postman 从 v9 开始支持单个 File 字段多选本地文件，这是最简洁的做法，无需手动添加多行同名 Key。
操作要点：
- Body → 选择
form-data - Key 栏输入后端期望的参数名，例如
files（不是files[]，也不是file，要和后端@RequestParam("files")一致） - Value 栏右侧下拉菜单选
File - 点击右侧
Select Files按钮，在弹窗中按住Ctrl（Windows）或Cmd（macOS）多选文件 - 发送请求，Wireshark 或后端日志可验证请求体中确实存在多个
Content-Disposition: form-data; name="files"; filename="a.jpg"结构
Spring Boot 后端接收必须用数组或 List，不能用单个 MultipartFile
如果控制器方法签名是 @RequestParam("files") MultipartFile file，Spring MVC 默认只取第一个 part，其余丢弃。必须显式声明为容器类型。
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
推荐写法（以 Spring Boot 3.x 为例）：
@PostMapping("/upload")
public ResponseEntity<String> upload(
@RequestParam("files") MultipartFile[] files) { // ✅ 数组接收
System.out.println("收到 " + files.length + " 个文件");
return ResponseEntity.ok("ok");
}
或者：
@PostMapping("/upload")
public ResponseEntity<String> upload(
@RequestParam("files") List<MultipartFile> files) { // ✅ List 接收，更灵活
files.forEach(f -> System.out.println(f.getOriginalFilename()));
return ResponseEntity.ok("ok");
}
注意：
- 不要在
@RequestParam上加required = false后又判空——若没传任何文件，files是空数组（length == 0），不是null - 如果同时需要文本参数（如
userId），直接在 form-data 里新增一行 Text 类型，Key 填userId，Value 填字符串，无需额外设置 Content-Type
容易被忽略的坑：批量上传时文件路径失效、环境变量未生效
Postman 批量运行（Collection Runner）时，Select Files 选的路径是相对当前工作目录的。如果没提前把文件复制到 Postman 设置里的 Location 目录，运行时会提示 “file not found” 或返回空文件。
解决方式只有两个：
- 打开 Postman Settings → General → Allow reading files outside working directory ✅（勾选）
- 把所有待上传文件**复制**（不是剪切）到 Settings 里显示的
Location路径下，再在Select Files中选择它们
另一个隐形问题：使用环境变量（如 {{baseUrl}}）时，form-data 的 Key 名不能含变量（比如 {{fileParamName}}），Postman 不解析 —— Key 必须是静态字符串，变量只能用在 URL 或 Text 类型的 Value 中。
