Postman中必须选form-data才能触发文件选择按钮，因其唯一支持文件上传；其他类型如raw或x-www-form-urlencoded无法激活“Select Files”控件，且手动设置Content-Type无效。
Postman 的 Body 必须选 form-data 才能触发文件选择按钮
如果点开 Body 后只看到 raw、x-www-form-urlencoded 等选项，却没出现 “Select Files” 按钮，说明当前 Body 类型不对。form-data 是唯一能让 Postman 渲染出文件选择控件的模式。其他类型（比如 raw）即使手动填了 Content-Type: multipart/form-data，也不会激活文件上传流程——Postman 不会解析 raw 内容里的边界（boundary），后端收不到合法 multipart 数据。
- 务必在 Body 标签页顶部明确选择
form-data - 不要在 Headers 里手动加
Content-Type：Postman 会自动生成带随机 boundary 的正确头，手填反而可能冲突 - 如果选了
form-data但 Key 右侧下拉仍是 Text，默认不会显示文件按钮；必须先在 Key 输入框填好字段名（如file），再点右侧下拉选File
Key 值必须和后端约定一致，且类型要切到 File
很多上传失败不是因为文件没选对，而是字段名或类型不匹配。比如后端接收参数叫 upload，你填了 file，或者 Key 写对了但下拉仍为 Text，Value 区域就只会显示输入框，根本不会弹出文件选择。
- Key 输入内容需与接口文档/后端代码完全一致（区分大小写，如
avatar≠Avatar） - Key 右侧下拉菜单必须手动切换为
File，不能依赖默认值 - 多个文件上传时，Key 名加
[]（如files[]）是常见做法，但最终是否生效取决于后端解析逻辑，Postman 本身只负责把多个文件塞进同一个字段名下
“Select Files” 按钮不响应？检查三个隐藏条件
点击按钮无反应、弹窗卡死、或选完文件后 Value 区域空白，通常不是 Postman 崩溃，而是被以下任一条件拦截：
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
- Postman 运行在浏览器版（Web 版）：目前 Web 版 不支持文件上传，必须用桌面客户端（Windows/macOS/Linux 安装版）
- 请求地址用了
localhost或127.0.0.1，但后端服务未启用 CORS 文件上传相关头（如Access-Control-Allow-Origin），此时控制台报CORS error，但按钮本身仍可点击——只是请求发不出去 - 文件路径含中文或特殊符号（如
测试.jpg、report v2(2026).pdf），某些旧版 Postman 会静默失败；建议先用纯英文无空格文件测试
上传后返回 400 或 500？先确认文件字段是否真被发出
Postman 的 Console（View → Show Postman Console）能直接看到原始请求体。打开后发送一次请求，找 Content-Disposition: form-data; 开头的块——如果有，说明文件字段已发出；如果整个请求体里只有文本参数、没有 filename= 行，那文件根本没进请求。
- 常见漏点：Key 名拼错、类型没切到
File、选了文件但没点 Send（按钮点了但网络延迟导致误以为没发） - 大文件（>100MB）可能触发 Postman 默认超时（约 0.5 分钟），可在 Settings → General → Request timeout 调高
- 部分后端框架（如 Spring Boot）要求额外配置
spring.servlet.multipart.max-file-size，仅调 Postman 无效
文件上传看似点几下，真正卡住的几乎全是字段名、类型、客户端版本这三处细节。尤其容易忽略的是：Web 版 Postman 根本不支持选文件——这点不验证，所有操作都是白忙。
