Postman怎么在JSON中引用变量_Postman请求体变量使用教程

风枫姑娘_4104

风枫姑娘_4104

2026-11-06

774人浏览

原创

Postman JSON 请求体中变量需加引号(字符串)或不加(数字/布尔),且须在 Pre-request Script 中用 pm.variables.set() 动态设置;变量优先级为 data > environment > global,未定义则为空字符串。

postman怎么在json中引用变量_postman请求体变量使用教程

Postman 的 JSON 请求体里不能直接写 {{variable}}——必须先确保变量已定义,且 JSON 语法不被破坏。

JSON 中写 {{variable}} 报错 “Unexpected token”

这是最常见问题:Postman 不会自动解析 JSON 字符串里的双大括号。它把 {{my_id}} 当成非法 JSON 字符,直接报 SyntaxError: Unexpected token {。

  • 根本原因:JSON 标准不支持模板语法,Postman 的变量替换只发生在「发送前」的预处理阶段,但前提是整个请求体被识别为“可插值文本”
  • 正确做法:把 Body 类型设为 raw,右侧语言选 JSON(不是 Text),然后手动确保变量外层有引号(字符串)或符合 JSON 类型(数字/布尔/null)
  • 错误示例:
    {"id": {{user_id}}, "name": "test"}
    → {{user_id}} 没引号,若值是 123 还能过,但如果是 abc 就崩
  • 正确示例:
    {"id": "{{user_id}}", "active": {{is_active}}}
    → 字符串加引号,布尔值不加(否则变字符串)

环境变量 / 全局变量 / 数据文件变量,该用哪个?

变量作用域决定你在哪里定义、怎么覆盖:

Postman 12.27.7
Postman 12.27.7

Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。

下载
  • environment 变量:适合测试不同环境(dev_api_url、staging_token),在右上角环境切换器里管理
  • global 变量:跨环境共享,比如 admin_email;但滥用会导致调试困难,改一个地方全项目受影响
  • data file(CSV/JSON 文件):配合 Collection Runner 批量跑不同参数,变量名来自文件首行,如 {"user_id":"101","role":"admin"} → 脚本里用 {{user_id}}
  • 注意:变量名冲突时,优先级是 data > environment > global;未定义的变量会被替换成空字符串,可能造成接口 400

需要动态生成值?用 Pre-request Script 写 pm.variables.set()

静态变量不够用时(比如时间戳、随机 ID、签名字段),必须在发请求前用脚本注入:

  • 在请求的 Pre-request Script 标签页里写:
    pm.variables.set("timestamp", Date.now().toString());<br>pm.variables.set("req_id", Math.random().toString(36).substr(2, 9));
  • 然后 JSON body 里就能安全用 {{timestamp}} 和 {{req_id}}
  • 关键点:pm.variables.set() 设置的是当前请求作用域变量,不影响环境或全局;若需持久化到环境,改用 pm.environment.set()
  • 别在脚本里拼 JSON 字符串再 set —— 那样容易引号嵌套出错;始终让变量存原始值,替换交给 Postman 做

真正容易被忽略的是变量类型隐式转换:比如 {{count}} 设为 "5"(字符串),放进 JSON "limit": {{count}} 就变成 "limit": "5"(字符串),而接口可能要求数字。要么脚本里用 parseInt() 存,要么在 JSON 里明确写 "limit": {{count}} 并确保变量值本身是数字类型(不带引号)。

相关专题

更多
软件测试常用工具
软件测试常用工具

软件测试常用工具有Selenium、JUnit、Appium、JMeter、LoadRunner、Postman、TestNG、LoadUI、SoapUI、Cucumber和Robot Framework等等。测试人员可以根据具体的测试需求和技术栈选择适合的工具,提高测试效率和准确性 。

2023.10.13

5070

8

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

0

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

0

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

0

16

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

2026.11.04

0

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

15

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

2026.11.04

0

16

XORM框架零基础入门教程
XORM框架零基础入门教程

本专题梳理XORM框架的入门路径,从框架定位、依赖安装、连接数据库到跑通第一个增删改查示例,讲清Engine初始化、日志开启与项目目录规划,并对比GORM等同类ORM的差异,帮助Go开发者建立整体认知。

2026.11.04

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Postman Native Git工作流指南
Postman Native Git工作流指南

共0课时 | 0人学习

Postman Vault密钥管理指南
Postman Vault密钥管理指南

共0课时 | 0人学习

Postman集合运行器使用指南
Postman集合运行器使用指南

共0课时 | 0人学习