Postman不支持自动为多文件分配不同字段名，需手动在form-data中为每个文件设置对应Key（如avatar、idCardFront等），且Type必须设为File；后端Spring Boot需用@RequestParam("xxx")逐个接收，字段名须完全一致，否则400错误。
Postman 本身不支持对多个文件自动分配不同字段名（比如 avatar、idCardFront、idCardBack），但你可以手动为每个文件指定独立的 Key，前提是后端接口明确接收这些不同名称的参数。
后端必须用@RequestParam("xxx")逐个声明字段名
如果你希望上传三个文件分别对应 avatar、idCardFront、idCardBack，Spring Boot 接口必须写成这样：
@PostMapping("/upload")
public String upload(
@RequestParam("avatar") MultipartFile avatar,
@RequestParam("idCardFront") MultipartFile idCardFront,
@RequestParam("idCardBack") MultipartFile idCardBack) { ... }
不能靠一个 List 自动映射——那样只接受相同 key 的多个值（如 files 出现三次）。
- 每个字段名必须与
@RequestParam中的字符串完全一致，包括大小写 - 任意一个字段为空时，Spring 默认会报 400 错误；加
required = false可选传，但需自行判空 - 如果后端用了
@RequestPart或封装了 DTO，字段名要和 DTO 属性名、JSON key 或表单 key 对齐
Postman 中必须手动添加多个 File 类型的 Key
在 Body → form-data 中，每行代表一个字段，Key 列填字段名，Type 列必须选 File，Value 点击 Select Files 选择对应文件：
-
avatar→ Type:File→ 选头像图片 -
idCardFront→ Type:File→ 选身份证正面 -
idCardBack→ Type:File→ 选身份证反面
注意：Content-Type 头部不要手动填写——Postman 会在发送时自动生成带 boundary 的 multipart/form-data；手动填错会导致服务端解析失败，返回 400 或空参数。
Postman 12.27.7
下载
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
常见错误：字段名拼错、类型没切到 File、或混用 Text
最容易踩的坑是：
- Key 写对了，但 Type 还是默认的
Text→ Postman 发送的是文件名字符串，不是二进制流 - Key 名多一个空格，比如
"avatar "→ 后端收不到，MultipartFile为null - 把多个文件拖进同一个
File字段 → Postman 只取第一个，其余静默丢弃（不会报错） - 同时在 Params 和 Body 里重复传同名字段 → Spring 优先取 form-data，但行为不稳定，建议只用 Body
需要动态字段名？得靠 Pre-request Script 拼接
如果你要批量测试不同组合（比如轮换上传 logo / banner / icon），Postman 原生不支持变量替换字段名。可行的变通方式是：
- 在 Pre-request Script 中用
pm.request.body.formdata.clear()清空，再用pm.request.body.formdata.add({key: ..., value: ...})动态添加字段（value 需配合pm.sendRequest读取本地文件，较复杂） - 更实际的做法：建多个保存的请求，每个对应一组固定字段名，避免运行时出错
- 真正需要灵活字段名的场景，建议改用脚本工具（如 curl + jq 或 Python requests）
字段名不是“配置项”，而是请求体结构的一部分；它一旦写死在 form-data 行里，就无法靠环境变量或模板语法替换——这点比 URL 或 JSON body 更硬性，容易被忽略。
