You need to enable JavaScript to run this app. 使用Postman form-data向API发送文件失败该如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.19 01:15:03