8.3 比对设置
比对设置决定「预期结果」与「实际出参」如何比较,属于文件级设置:随 .tst 文件保存,重新打开后仍然有效,同一测试文件内的所有用例共用一套设置。点击工具条【比对设置】打开对话框。

8.3.1 设置项
| 设置项 | 说明 | 默认值 |
|---|---|---|
| 比对模式 | 严格:比对预期结果中的全部字段;白名单:只比对指定路径 | 严格 |
| 忽略路径 | 每行一条,命中的子树整体跳过(不参与比对) | 空 |
| 白名单路径 | 每行一条,仅白名单模式生效;白名单模式下至少填写一条 | 空 |
| 数值容差 | 数值比较允许的绝对误差,0 表示严格相等 |
0 |
| 单用例差异上限 | 单个用例最多展示的差异条数 | 50 |
| 忽略实际出参多出的字段 | 勾选后,预期结果中没有、实际出参中多出的字段不视为差异 | 勾选 |
填写规则:
- 路径使用
.分隔层级,数组下标写作a.b[0].c; - 数组全部元素可写作
items[].status或items[*].status; - 忽略路径与白名单路径支持换行、逗号、分号分隔,重复项自动去重;
- 【恢复默认】把草稿恢复为默认设置,【保存】写回测试文件并标记文件已修改。
8.3.2 与判定结论的关系
- 比对设置会随执行请求一并下发给服务端,服务端据此判定每条用例的
passed,因此服务端的通过 / 失败与详情面板的「字段差异」使用同一套口径; - 若服务端版本尚未支持该参数,判定仍按服务端默认口径执行,此时本地差异面板仅作为参考;
- 调整比对设置后建议重新执行一次:结论是按执行时的设置判定的,历史结果不会自动重算;
- 浏览器端需先保存测试文件,比对设置才会随文件进入数据库并被服务端读取。
8.3.3 常见用法
| 场景 | 建议设置 |
|---|---|
| 校验全部返回字段是否一致 | 严格模式,不填忽略路径 |
| 返回结果含流水号、时间戳等易变字段 | 忽略路径填写 traceId、requestTime 等字段 |
| 只关心少数关键出参 | 白名单模式,填写 resultCode、level 等关键字段 |
| 金额、比率存在精度差异 | 设置合适的数值容差 |
| 出参新增了字段但业务不关心 | 保持「忽略实际出参多出的字段」勾选 |