Postman模拟多选表单需分场景:form-data中同名Key(如files[])手动添加多行并选文件;x-www-form-urlencoded通过Bulk Edit粘贴多行同名键值对(如tag=ios↵tag=android);不可用raw+JSON传文件。

Postman 本身不支持“多选下拉框”这类前端交互控件的模拟,所谓“提交多选结果”,本质是后端约定的多种表单编码方式之一,关键在 form-data 或 x-www-form-urlencoded 中如何构造多个同名字段或数组式键名。
form-data 中提交多个同名文件字段(如 files[])
这是上传多个文件时最常见也最容易出错的场景。Postman 不会自动合并多个 file 字段,必须手动添加多行,且 Key 名需完全一致(包括方括号)。
- 在 Body →
form-data中,点击 “Add row” 多次 - 每一行 Key 都填
files[](注意:不是files,也不是files[0]),Value 类型选File,再分别选择文件 - 不要手动设置
Content-Type头——Postman 会自动生成带boundary的multipart/form-data,改了反而导致解析失败 - 后端需用
List(Spring Boot)或$_FILES['files'](PHP)接收,不能用单个MultipartFile
x-www-form-urlencoded 提交多个同名文本参数(如 tag=ios&tag=android)
这种形式常用于筛选标签、权限组等纯文本多选场景,但 Postman 默认 UI 不允许 Key 重复,得靠“Bulk Edit”绕过限制。
- 切换到 Body →
x-www-form-urlencoded - 点击右上角
Bulk Edit - 直接粘贴多行键值对,例如:
tag=ios tag=android tag=web
- 发送后,Postman 会自动拼成
tag=ios&tag=android&tag=web,并设Content-Type: application/x-www-form-urlencoded - 后端收到的是字符串数组(如 Spring 的
@RequestParam List),不是逗号分隔的单字符串tag
为什么选 form-data 而不是 raw + JSON?
当混合了文件和文本参数(比如上传图片同时带 caption、category),raw 格式完全不可用——JSON 无法嵌入二进制文件流,浏览器原生表单也不支持。只有 form-data 能正确分隔不同部分并携带 filename 和 Content-Type。
-
raw+JSON只能传文本数据,哪怕你把文件 base64 编码进去,也是额外增加体积和后端解析负担 -
form-data每个字段可独立设类型:文本字段用Text,文件字段用File,互不干扰 - 若强行在
raw中发 multipart 请求,边界符(boundary)必须手写,极易格式错误,99% 的“请求解析失败”都源于此
容易被忽略的兼容性细节
不同后端框架对同名字段的默认处理逻辑不同,同一个 Postman 配置可能在 Spring Boot 成功,在 Flask 或 Express 中失败。
- Spring Boot 默认接受
files[]并转为List;但 Flask 的request.files.getlist('files[]')要求 Key 精确匹配,少一个[]就只拿到第一个 - Node.js 的
multer中,array('files')对应 Key 是files,不是files[];而fields模式才支持带方括号的命名 - Postman 的
Select Files多选功能(Cmd/Ctrl + 点击)只适用于单个 Key 行,它会把所有选中文件塞进那一行——这适合上传同名多文件,但不适用于需要不同 Key(如avatar、cover)的场景











