Postman传参需严格匹配参数类型、位置和编码方式:GET参数填Params栏,POST根据Content-Type选raw JSON或x-www-form-urlencoded,Header中Authorization须带Bearer前缀并留空格,环境变量与脚本按需使用。

Postman 传参不是选“Params”就完事——参数类型、位置、编码方式不匹配,90% 的 400 或空响应都源于此。
GET 请求的 query 参数必须填在 Params 栏,不能写在 URL 后面手动拼
很多人把 https://api.example.com/user?id=123&name=test 直接粘贴进 URL 输入框,结果 Postman 不识别或重复编码。正确做法是:
- URL 只保留基础路径:
https://api.example.com/user - 点开
Params栏,逐行填id→123、name→test - Postman 会自动 URL 编码(比如空格变
%20),且支持一键清空/导出 - 如果后端用 Spring Boot,
@RequestParam默认要求非空,记得勾选Required或传默认值,否则可能 400
POST 请求体传参:raw JSON 和 x-www-form-urlencoded 完全不同
选错 body 类型,后端收不到字段是常态。关键看接口文档写的 Content-Type:
- 要发 JSON 数据 → 切到
raw,右侧下拉选JSON,然后写:{ "user_id": 456, "status": "active" } - 表单类提交(如登录)→ 选
x-www-form-urlencoded,在键值对栏填username→admin、password→123456;Postman 会自动编码并设 headerContent-Type: application/x-www-form-urlencoded - 误把 JSON 粘在
form-data里?字段会被当文件名处理,后端解析为空
Header 里传 token 或自定义字段,别漏掉 Authorization 前缀
很多接口要求 Bearer Token,但只填值不填前缀会失败:
Postman Mac版是一款专为macOS设计的API开发与测试工具,凭借简洁的界面和强大的功能,深受开发者喜爱。它支持发送各种HTTP请求(GET、POST、PUT等),轻松管理接口集合、环境变量和模拟服务器。Mac用户可享受原生性能、快捷键优化及与系统无缝集成的体验,适用于接口调试、自动化测试和文档生成。无论是个人项目还是团队协作,Postman for Mac都能提升API开发效率,是ma
- Header 栏加一行:
Authorization→Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9... - 不是
token: xxx,也不是Bearerxxx(少空格) - 其他常见 header:
Accept→application/json(影响返回格式)、X-Request-ID→req-789(调试追踪) - 如果 header 值含中文或特殊符号,Postman 不自动编码,需手动 URL 编码(如用
encodeURIComponent处理后再粘贴)
环境变量和预请求脚本适合动态参数,但别滥用
需要每次请求带时间戳、随机数、或从上个响应取 access_token 时才用:
- 定义环境变量
base_url和auth_token,URL 写成{{base_url}}/v1/users,Header 的Authorization填Bearer {{auth_token}} - 在
Pre-request Script里生成时间戳:pm.environment.set("now", Date.now().toString());,然后在 Params 或 Body 里引用{{now}} - 注意:脚本执行顺序在请求发起前,但变量不会自动刷新;若依赖上个响应,得在
Tests里用pm.response.json()提取并 set,否则还是旧值
真正容易被忽略的是:Postman 的 Params 栏对 GET 生效,但对 POST + raw JSON 完全无效;而 Body 下的 form-data 会强制 multipart 请求,连 header 都会变。调不通时,先看 Network 面板里实际发出的请求结构,再比对后端接收逻辑。









