Postman上传PDF文件必须使用form-data类型，且不可手动设置Content-Type；否则会破坏boundary导致后端解析失败。Key需匹配后端约定（如file），Value类型须选File并正确选择文件，多文件需用files[]等数组形式，Headers通常仅需Authorization。
Postman 上传 PDF 文件不需要手动设置 Content-Type，选对 body 类型和字段类型就能跑通；手动填错 Content-Type 反而会破坏 multipart 边界，导致后端收不到文件。
form-data 是唯一正确的 Body 类型
PDF 属于二进制文件，必须走 multipart/form-data 协议传输。Postman 中只有 form-data 模式能自动构造合法的 boundary、Content-Disposition 和文件 MIME 头部。
- 别用
raw+ 手动拼 JSON：PDF 二进制无法嵌入 JSON 字符串 - 别用
x-www-form-urlencoded：它只处理纯文本键值对，不支持文件流 - 别用
binary：它只发单个原始文件体，无法同时带文本参数（如title、category） - 选
form-data后，Postman 会自动生成合规的Content-Type: multipart/form-data; boundary=----WebKitFormBoundary...，你不用管也不该改
File 字段必须匹配后端约定的 key 名
后端代码（比如 Spring Boot 的 @RequestParam("document") MultipartFile file）依赖 key 名定位文件。这个 key 就是你在 Postman form-data 的 Key 列里填的内容。
Postman 12.27.7
下载
Postman 12.27.7 Windows x64 官方安装包，适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力，以及接口规范标签管理改进，适合受限网络测试与规范资源组织场景。
- 如果后端期待
file，Key 就填file；如果期待pdfDocument，Key 就填pdfDocument - Value 列右侧下拉菜单必须选
File（不是Text），然后点Select Files按钮选本地 PDF - 多个 PDF 上传？Key 填
files[]或后端明确支持的数组形式（如documents），再在文件选择对话框中按住 Ctrl/Cmd 多选
Headers 通常留空，除非接口强制要求认证或特殊头
绝大多数文件上传接口只要求身份凭证，其他头由 Postman 自动注入。手动加错反而出问题。
-
Content-Type：绝对不要手动填写 —— Postman 在你选form-data后已生成完整且动态的值，覆盖它会导致 boundary 不匹配，后端解析失败 -
Authorization：如有 JWT 或 API Key，填Bearer xxx或API-Key: xxx，否则 401 -
Accept：可选填application/json，方便看结构化响应 - 其他头（如
User-Agent、Origin）一般无需干预
上传失败时优先检查这三处
常见报错如 400、500、空响应体，往往不是代码问题，而是 Postman 配置偏差。
- Key 名拼错或大小写不符（
pdf≠Pdf≠PDF） - 误把 PDF 拖进
Text类型字段 —— 此时 Postman 会尝试读取二进制为字符串，传过去的是乱码，后端直接拒收 - 环境变量未切换（比如用了
{{baseUrl}}却没选对应环境），URL 实际为空或错误 - PDF 文件过大，触发了后端 Nginx 或 Spring 的默认限制（如 Spring 的
spring.servlet.multipart.max-file-size=10MB），需同步调大并重启服务
真正容易被忽略的是：Postman 的 form-data 模式下，每个字段都独立判断类型，File 和 Text 不能混用同一个 Key 行 —— 想传 PDF 又想传说明文字，就得开两行，Key 分别为 file 和 description，类型各选其一。
