集合级Tests脚本仅在Collection Runner中运行且需勾选“Run collection-level scripts”,Pre-request Script每次请求前执行但变量作用域为local,pm.sendRequest()在集合脚本中禁用。

集合级 Tests 脚本根本没运行
Postman 的集合级 Tests 脚本(即在 Collection > Tests 里写的脚本)不会自动执行——它只在你用 Collection Runner 运行整个集合时触发,**不会在单个请求点击 Send 时运行**。这是最常被忽略的前提。
常见错误现象:pm.test 或 console.log 完全没输出,Postman Console 里空空如也;但把同样脚本挪到单个请求的 Tests 里就立刻生效。
- 确认你是在 Collection Runner 中启动的集合,而不是手动点某条请求的 Send
- 检查 Runner 界面右上角是否勾选了 “Run collection-level scripts”(默认可能未勾选)
- 集合 Tests 只对当前集合下的所有请求生效,不作用于子文件夹或嵌套集合
Pre-request Script 在集合里写却没生效
集合级 Pre-request Script 的执行时机很特殊:它会在**每个请求发送前**执行一次,但它的作用域是“为该请求准备上下文”,不是“为整个集合预热”。如果脚本里用了 pm.variables.set() 却发现后续请求拿不到,大概率是因为变量作用域没设对。
关键限制:pm.variables.set() 在集合级脚本中创建的是 **local 变量**,仅对该次请求生效,不会透传给下一个请求。
- 需要跨请求共享数据?改用
pm.environment.set()或pm.globals.set() - 想让某个值在所有请求里都可用,但又不想污染全局?在集合 Settings > Variables 里直接定义集合变量(
collection-level variable),它比 environment 优先级低、比 global 高,且无需脚本赋值 - 注意:集合变量无法在 Pre-request Script 中通过
pm.variables.get()读取,必须用pm.collectionVariables.get()
脚本报错导致后续逻辑跳过
Postman 脚本是同步执行、遇到错误就中断的。集合级 Tests 或 Pre-request Script 里只要有一行抛出 JS 异常(比如 undefined.xxx),整段脚本就会停在那里,后面所有 pm.test 或 pm.environment.set 都不会执行。
典型表现:Console 里只看到前半段 log,断言数量比预期少;或者环境变量始终是旧值。
- 所有集合级脚本开头加
try { ... } catch (e) { console.error("集合脚本异常:", e); } - 避免直接访问可能为
undefined的响应字段,先用res?.json?.data或typeof res.json === 'object'做守卫 - Postman Console 的日志默认只显示最后 100 行,大量调试输出容易被刷掉;建议用
console.group("xxx")+console.groupEnd()分组查看
newman 运行时集合脚本行为不一致
newman 默认会执行集合级脚本,但它对变量和异步操作的支持与 Postman GUI 有细微差异。最常踩的坑是:GUI 里能跑通的 pm.sendRequest(),在 newman 里返回 undefined 或直接报错。
根本原因:pm.sendRequest() 在集合级脚本中是被禁用的(Postman 官方明确限制),但在某些旧版本 GUI 中因缓存或状态残留看似“能用”,newman 则严格校验。
- 别在集合 Tests 或 Pre-request 中调用
pm.sendRequest(),它只允许在单个请求的脚本中使用 - 需要前置发起一个请求来获取 token?把它做成第一个请求,用 Tests 提取并存入 environment,后续请求直接引用
{{token}} - newman 执行前务必确认环境文件路径正确,
-e参数指定的 JSON 必须是 Postman 导出的 v2.1 格式,否则变量加载失败会导致脚本里pm.environment.get()返回undefined
集合脚本的“作用范围”不是靠代码位置决定的,而是由执行入口(Send / Runner / newman)、变量 API 选择(pm.variables vs pm.environment)、以及 Postman 自身的执行沙箱规则共同约束的。最容易被忽略的一点是:**集合级 Pre-request Script 不是“集合启动时运行一次”,而是“每个请求前都运行一次,且每次都是干净的 local 上下文”**。











