Postman 请求头必须精准配置,否则易导致401/400错误;Content-Type需匹配请求体格式,Authorization须严格遵循格式要求,Bulk Edit需谨慎使用,推荐手动核对关键头,预请求脚本适合动态生成Header,且需关闭默认全局headers以防干扰。

Postman 里加请求头不是“要不要加”的问题,而是“加错就收不到响应”或“直接 401/400”的问题。绝大多数接口失败,根源在 Content-Type 或 Authorization 没对,而不是 URL 写错了。
Content-Type 不匹配是最常见的 400 原因
服务器按 Content-Type 解析请求体,类型不对,它根本不会去读你传的 JSON 或表单数据。
-
application/json:对应Body→raw→JSON,值必须是合法 JSON 字符串(比如{"name":"Alice"}),不能多逗号、不能单引号 -
application/x-www-form-urlencoded:对应Body→form-data或urlencoded,Postman 会自动编码,但别手动填错字段名 -
multipart/form-data:仅用于文件上传;千万别手动改这个值,Postman 在选form-data后会自动生成带 boundary 的完整头,手改会导致解析失败
Authorization 头写法必须严格符合 API 要求
写错一个空格、少一个 Bearer、token 多了空行,服务器就当没认证。
- 格式通常是
Authorization: Bearer,注意Bearer和 token 之间是英文空格,不是中文空格或制表符 - token 来源要可靠:从登录响应的
response.body.token或response.headers.Set-Cookie提取,别手输、别复制带换行的 token - 如果 API 要
API-Key,就别写成X-API-Key或apikey—— 必须和文档写的 key 名完全一致,大小写敏感
Headers 标签页里的“Bulk Edit”能救急但容易翻车
从浏览器 DevTools 或 Charles 抓包复制的原始请求头,粘贴进 Postman 的 Bulk Edit 看似省事,但有隐藏风险:
Postman Mac版是一款专为macOS设计的API开发与测试工具,凭借简洁的界面和强大的功能,深受开发者喜爱。它支持发送各种HTTP请求(GET、POST、PUT等),轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验,适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作,Postman for Mac都能提升API开发效率,是ma
- 浏览器抓到的头可能含
Host、Connection、Upgrade-Insecure-Requests等 Postman 不该发的头,留着可能触发服务端校验拦截 - 某些头值含换行或不可见字符(比如 \r\n),Bulk Edit 不报错,但实际发送时被截断
- 推荐做法:只复制关键头(
Authorization、Content-Type、X-Request-ID),其他一律删掉;粘贴后点Key-Value Edit再逐行核对
环境变量 + 预请求脚本适合动态 Header
当你需要每次发请求都自动注入时间戳、签名或临时 token,硬编码在 Headers 里不现实。
- 在
Pre-request Script里用pm.environment.set('X-Sign', signValue)计算并存值 - Headers 中直接写
X-Sign: {{X-Sign}},Postman 会自动替换 - 注意:预请求脚本里不能用
pm.sendRequest异步取 token 再塞进 header —— 它是同步执行的,异步结果还没回来 header 就发出去了
真正容易被忽略的是:Postman 的 Headers 选项卡默认开启 “继承全局 headers”,如果你在 Settings → General 里勾了 “Send default headers”,它会悄悄加上 User-Agent、Accept 等,而某些老旧 API 会因为多了个 Accept: */* 直接拒收。遇到玄学失败,先关掉这个开关试试。









