使用Postman form-data向API发送文件失败该如何解决?
Postman 上传文件字段显示undefined问题解决方案
必查基础配置
- 确认请求方法为
POST/PUT,Body选项卡选择form-data格式 - 对应文件字段的Key列最右侧下拉框必须选择File类型,默认Text类型下即使选择了文件也会发送空值
- 核对文件字段的Key拼写、大小写与服务端接收字段完全一致,无多余空格
- 确认所选文件路径有效、文件未被删除/锁定、Postman有文件读取权限
你提供的请求体截图如下:
已尝试基础方案无效后的进阶修复
- 重置Postman默认配置:依次点击左上角
File → Settings → General → Reset settings,重置完成后完全关闭客户端再重新打开测试 - 清理隐藏请求头:切换到Headers选项卡,点击
Hidden按钮查看自动生成的请求头,如有强制设置的非multipart/form-data类型的Content-Type,手动删除后重试 - 禁用自定义脚本:检查Pre-request Script、Tests选项卡是否存在修改请求体/请求头的自定义代码,全部注释后再测试
- 更换Postman版本:v10部分小版本存在form-data传文件的已知bug,可卸载当前版本后安装v9.x稳定版验证
- 若使用网页版Postman,清空浏览器站点缓存、Cookie后重新登录测试
内容的提问来源于stack exchange,提问作者Chris
相关产品推荐
相关产品推荐


