Postman默认不支持JSON深度相等断言,因Chai v4.x禁用deep.equal且.eql()不递归比较;推荐用JSON.stringify(obj, null, 0)标准化后字符串比对,或手动注入lodash.isEqual实现语义级深度比较,但应聚焦关键字段而非全量比对。

Postman 本身不提供开箱即用的 JSON 深度相等断言(pm.expect(a).to.deep.equal(b) 在旧版 Postman 中默认不可用),直接用 === 或 .eql() 比较两个解析后的对象,90% 会失败——因为对象引用不同,或浮点数/undefined/NaN/日期等类型处理不一致。
为什么 pm.expect(jsonData).to.eql(expected) 经常误报 FAIL
Postman 默认使用 Chai 的浅层 eql 断言,它对嵌套对象、数组顺序、空值和键顺序敏感。例如:
- 响应中
{"a": 1, "b": 2}和预期{"b": 2, "a": 1}—— 键序不同 → FAIL - 响应中
[1, 2, null]vs 预期[1, 2]→null被忽略但长度不同 → FAIL - 响应含
new Date("2024-01-01")(实际不会出现,但若后端返回时间戳字符串,你手动转成 Date)→ 类型不匹配 → FAIL
根本原因:Postman 内置的 Chai 版本(v4.x)默认禁用 deep.equal,且 .eql() 不递归比较嵌套结构的等价性。
用 JSON.stringify() 做标准化比对(最稳、兼容所有 Postman 版本)
绕过对象引用和序列化差异,统一转为字符串再比对。前提是:双方 JSON 结构语义一致,且你控制序列化格式(避免空格、换行、键序干扰)。
- 必须用
JSON.stringify(obj, null, 0):第三个参数0表示不缩进,强制扁平化输出,消除格式差异 - 不能用
responseBody原始字符串直接比——它可能带 BOM、多余空格或编码问题;必须先pm.response.json()解析再重序列化 - 如果预期 JSON 含动态字段(如时间戳、ID),需先从响应中剔除或替换为占位符
示例(比对整个响应体是否与预期 JSON 完全一致):
const actual = pm.response.json();
const expected = {
"status": true,
"data": {"id": 123, "name": "test"}
};
// 标准化为无空格、键序固定的字符串
pm.test("Response body matches expected JSON", () => {
const actualStr = JSON.stringify(actual, null, 0);
const expectedStr = JSON.stringify(expected, null, 0);
pm.expect(actualStr).to.equal(expectedStr);
});
用 _.isEqual() 做真正深度比较(需手动注入 Lodash)
Postman 允许在脚本中执行任意 JS,可借助 CDN 注入轻量版 Lodash(仅 isEqual),实现语义级深度相等判断(忽略键序、处理 NaN === NaN、跳过 undefined 字段等)。
Postman 12.27.7 Windows x64 官方安装包,适用于 API 设计、调试、测试与协作。该系列包含 Enterprise 云端性能测试静态 IP 出口能力,以及接口规范标签管理改进,适合受限网络测试与规范资源组织场景。
- 从
https://cdn.jsdelivr.net/npm/lodash@4.17.21/isEqual.min.js获取压缩版isEqual函数源码(约 1.2KB) - 在 Tests 中顶部粘贴该函数(不要用
import,Postman 不支持 ES module) - 调用时传入两个已解析的 JSON 对象,不是字符串
示例:
// 手动注入 lodash.isEqual(精简版,仅此函数)
const isEqual = (a, b) => { /* ... 粘贴 minified isEqual 实现 ... */ };
<p>const actual = pm.response.json();
const expected = {"data": [1, 2], "meta": {"count": 2}};
pm.test("Deep equal with Lodash", () => {
pm.expect(isEqual(actual, expected)).to.be.true;
});</p>
⚠️ 注意:isEqual 无法跨环境自动加载,每次更新 Postman 或清缓存后需重新粘贴;也不适用于超大响应(性能下降明显)。
只比关键路径,别比整个 JSON
生产环境中,99% 的断言不需要全量比对。过度依赖“完全一致”反而掩盖真实问题(比如新增了兼容字段、时间精度变化)。应聚焦业务契约:
- 用
pm.expect(actual.status).to.equal(1)单独断言状态码字段 - 用
pm.expect(actual.data.length).to.be.at.least(1)断言列表非空 - 对嵌套字段链式取值:
pm.expect(actual.data[0].user.id).to.exist - 用正则或
includes()检查字符串字段是否含预期关键词,而非死扣全文
真正的稳定性来自“契约明确 + 路径精准”,而不是把整棵 JSON 树拍扁塞进一个断言里。一旦接口加了新字段或调整了空值策略,全量比对就会立刻崩。










