Postman中多个同名字段生效需明确声明多值并匹配后端接收方式：x-www-form-urlencoded需手动添加多行相同key；form-data支持同名文件/文本；后端Java必须用@RequestParam数组或List接收，否则仅取首个值。
Postman里怎么让多个同名字段生效
Postman 默认不会自动合并同名字段——你手动加两行 fruit，它不会自动打包成数组；它只是把后一个覆盖前一个，或者（取决于 Body 类型）拼成非法格式。必须明确告诉 Postman：“这是多值”，且后端也要按多值方式接收。
x-www-form-urlencoded 中重复 key 的正确写法
在 Body → x-www-form-urlencoded 模式下，Postman 允许添加多个相同 key，但前提是：每一行都独立填写，不能靠“复制粘贴键名”偷懒。常见错误是只改 value、忘了删掉上一行的 key，导致实际只提交了最后一个。
- ✅ 正确操作：点击右下角
+新增一行，手动输入fruit作为 key，再填Apple；再点+，再输一次fruit和Banana - ❌ 错误操作：复制第一行，只改 value，结果第二行 key 变成空或乱码，Postman 忽略该行
- ⚠️ 注意：
Content-Type会由 Postman 自动设为application/x-www-form-urlencoded，不用手填；但如果手动改过 Header，务必确认它没被覆盖成text/plain等无效值
form-data 模式下传多个同名文件或文本字段
当字段用于上传多个文件（比如 files[]），或混合传文件+文本时，form-data 是唯一可靠选择。它天然支持同名字段，且能区分文件和普通字符串。
Postman 12.27.7
下载
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
- Key 列填
files[]，Value 列选File类型并上传第一个文件 - 再点
+，Key 再填files[]（完全一样），Value 换第二个文件 - 如果还要传普通文本同名字段（如
desc出现两次），同样用两个desc行，Value 类型选Text - ⚠️ 后端接收时，Java 需用
@RequestParam("files[]") List，不是单个files MultipartFile
后端不配合，前端再怎么填也没用
Postman 能发出去，不代表后端能收全。最容易忽略的是 Java Spring 的默认行为：@RequestParam("fruit") String fruit 永远只取第一个值；必须显式声明为数组或集合：
-
@RequestParam("fruit") String[] fruits→ 接收为字符串数组 -
@RequestParam("fruit") List→ 更常用，Spring 自动转换fruits - Servlet 原生写法：
request.getParameterValues("fruit")返回String[]，空则为null，不是空数组 - ⚠️ 如果后端用了
@RequestBody却传了x-www-form-urlencoded，整个请求体解析会失败，连日志都看不到原始参数
真正卡住的地方往往不在 Postman 怎么点，而在后端注解类型和 Content-Type 是否匹配——多试一次 getParameterValues 打印日志，比反复调 Postman 更快定位问题。
