Postman上传图片失败主因是手动设置Content-Type导致boundary丢失、Headers冗余或form-data中key类型未切为File；应删除手动Content-Type，确保自动生成功能启用，并将字段类型设为File后选择本地文件。
Postman 上传图片失败，八成是 Content-Type 手动设了、Headers 多写了，或者 form-data 里没把 key 的类型切到 File。
为什么手动加 Content-Type: multipart/form-data 会失败
Postman 在你选 form-data 后，会自动生成带唯一 boundary 的 Content-Type，比如 multipart/form-data; boundary=----WebKitFormBoundaryabc123。如果你手动填了不带 boundary 的值（如只写 multipart/form-data），服务端解析时找不到分隔符，直接报 400 Bad Request 或静默丢弃。
- 绝对不要在
Headers标签页手动添加Content-Type - 如果已加过，删掉；检查
Body → form-data左下角是否显示 “Content-Typewill be set automatically” - 需要认证时，只加
Authorization（如Bearer xxx）或Cookie，其他头一律清空
form-data 中 file 字段怎么配才有效
key 名必须和后端约定一致（常见为 file、image、avatar），但关键在 value 类型：它必须是 File，不是 Text，也不是留空。
Postman Mac版
下载
Postman Mac版是一款专为macOS设计的API开发与测试工具，凭借简洁的界面和强大的功能，深受开发者喜爱。它支持发送各种HTTP请求（GET、POST、PUT等），轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验，适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作，Postman for Mac都能提升API开发效率，是ma
- 在
Key列输入字段名（例如file） - 点击该行右侧下拉箭头，从
Text切换为File—— 此时Value栏才会变成“Select Files”按钮 - 点按钮选本地图片（支持
.jpg、.png等，注意后端是否限制 MIME 类型） - 若接口还需传文本参数（如
title或size），在同一form-data区域另起一行，Key填参数名，类型保持Text，Value直接输值
上传成功但返回 URL 访问 404 怎么排查
返回 JSON 里有 url 字段不代表链接一定能打开，常见原因是路径拼接错误或权限问题。
- 先确认响应状态码是
200或201，且 JSON 中url字段非空（如"url": "/media/abc.jpg"） - 把
url拼到服务地址后面访问（例如服务地址是http://localhost:8000，则完整 URL 是http://localhost:8000/media/abc.jpg） - 如果 404，检查后端是否配置了静态文件路由（如 Django 需
urlpatterns += static(...)，Express 需express.static()） - 用浏览器开发者工具的 Network 标签，看这个 URL 请求是否被重定向、是否带了多余前缀（如多出了
/api）
批量测试或多尺寸上传时容易忽略的坑
单次上传能过，批量跑就报“file missing”，往往不是接口问题，而是 Postman 的文件读取路径限制。
- Postman 默认禁止读取工作目录外的文件；批量运行（Collection Runner）时会触发该限制
- 进
Settings → General → Allow reading files outside working directory，打开开关 - 把测试图片复制到 Postman 显示的
Working directory路径下（不是剪切，是复制） - 如果用环境变量动态切换图片（如
{{img_path}}），确保路径是相对 working directory 的，且文件存在
真正卡住人的地方，往往不是怎么传，而是传完之后那个返回的 url 到底能不能直接当链接用——它可能缺协议、少域名、带错前缀，甚至只是后端忘了开静态资源服务。
