POSTMAN中multipart/related文件上传API请求配置方法

基础请求配置 #

• 打开Postman新建HTTP请求，请求方法选择POST（multipart类上传接口默认使用POST方法，若接口文档指定其他方法可按需调整），在顶部地址栏填入给定接口地址：https://apiq-jmqny-ste.azpre-api.net

请求头配置 #

• 切换到Headers标签页，手动添加1条请求头规则：
  • Key：Content-Type
  • Value：multipart/related; boundary=Acb067

关键注意事项：必须取消Postman默认的Content-Type自动勾选/自动填充功能，否则Postman会自动覆盖自定义的boundary值，直接导致服务端解析请求失败。

请求体配置（核心步骤） #

multipart/related类型无法直接通过Postman自带的form-data可视化面板配置（该面板固定生成multipart/form-data格式请求），需要手动拼接符合规范的请求结构：

1. 切换到Body标签页，选择raw类型，右侧格式下拉框选择Text（禁止选择JSON、Form-data等自动格式化选项，避免工具自动篡改请求结构）
2. 在编辑框中先输入如下固定结构内容，注意格式、换行完全和示例一致：

--Acb067
Content-Type: application/json; charset=UTF-8

{"token" : "aqop094567","flow" : "work"}
--Acb067
Content-Type: application/pdf
Content-Disposition: attachment; filename="Pt_003.pdf"

格式提示：上述内容最后一行必须保留空行，空行位置即为PDF文件内容的插入位置；每个分段的头部和实际内容之间必须空一行，这是multipart格式的强制规范。

3. 将光标定位到上述内容最后的空行位置，右键编辑区选择「Insert file content」（部分版本在编辑区右上角有Select file按钮），选择本地待上传的Pt_003.pdf文件，Postman会自动将文件二进制内容插入到光标位置。
4. 在插入完成的PDF二进制内容下一行，输入结束分隔符--Acb067--，完成整个请求体拼接。

发送前校验与请求发送 #

点击Send前先核对3个关键配置项，避免无效请求：

• 确认Headers中的Content-Type值未被Postman自动修改，boundary值始终为指定的Acb067
• 确认请求体中所有分隔符和Headers指定的boundary值完全一致，开头分隔符带--前缀、结尾分隔符带--后缀，无拼写错误
• 确认JSON分段无多余格式字符、PDF分段的文件名与本地选择的文件一致、各分段之间的空行无遗漏

常见问题排查 #

• 返回400 Bad Request：优先检查Content-Type是否被自动篡改，boundary值是否前后一致
• 返回文件解析失败：检查PDF分段的Content-Type是否为application/pdf，文件名是否带.pdf后缀，分段头和内容之间的空行是否被误删
• 提示参数缺失：检查JSON分段的内容是否和给定值完全一致，无多余转义或空格

内容的提问来源于stack exchange，提问作者avidey