当前位置：首页 > news >正文

【测试工具JMeter篇】JMeter性能测试入门级教程（七）：JMeter断言

news 来源：原创 2025/5/14 18:39:33

一、前言

在 JMeter 中，断言元件（Assertion）用于验证测试结果是否符合预期。断言元件可以检查服务器的响应数据，以确保它们符合期望的模式或值，从而验证性能测试脚本的正确性。断言元件通常在每个请求的响应中添加，以确保服务器返回了正确的响应。

二、常用的JMeter断言元件

1. 常用断言元件

Response Assertion（响应断言）
Size Assertion（大小断言）
XPath Assertion（XPath 断言）
JSON Assertion（Json 断言）

2. 断言添加方式：

根据需要可在【测试计划】、【线程组】、【线程请求】下添加断言，一般在对应的【线程请求】下添加，如下图所示。
添加路径：【线程请求-点击右键-添加-断言-对应的断言形式】

3. 查看断言结果

3.1 【断言结果】看断言结果

添加路径：【测试计划-点击右键-添加-监听器-断言结果】

在这里插入图片描述

整个测试计划下所有请求的所有断言结果报错信息均会在此显示，如下图所示，将所有断言结果的报错信息直接展示出来。

在这里插入图片描述

3.2【查看结果树】看断言结果

添加路径：【测试计划-点击右键-添加-监听器-查看结果树】，整个测试计划下所有请求的所有断言结果报错信息均会在此显示，如下图的形式，切换查看。

在这里插入图片描述

三、断言元件的详细介绍

3.1 Response Assertion（响应断言）

3.1.1 简介

用于检查服务器响应的内容是否符合预期，可以基于响应的内容、代码、消息或其他属性进行断言。可以根据响应文本、响应代码、响应消息和其他参数来定义断言条件，并指定断言模式（包含、匹配、不包含等）。

3.1.2 参数配置介绍

Apply to 选项默认即可，Main sample only(仅作用于父节点取样器)。
测试字段:要检查的项 (实际结果)
- Text Response:来自服务器的响应文本。
- Response Code:响应的状态码，例如:200。
- Response Message:响应的信息，例如: OK。
- Response Headers: 响应头部
- Request Headers: 请求头部
- Request Data:请求数据
- URL 样本:请求 URL
- Document(text): 响应的整个文栏
- 忽略状态:忽略返回的响应状态码
模式匹配规则:比较方式（校验规则）
- contains（包括）:文本包含指定的正则表达式
- Matches（匹配）:整个文本匹配指定的正则表达式
- Equals（等于）:整个返回结果的文本等于指定的字符串（区分大小写）
- substring:返回结果的文本包含指定字符串(区分大小写)
- 否: 取反
- 或者:如果存在多个测试模式，勾选代表逻辑或(只要有一个模式匹配，则断言就是 ok)，不勾选代表逻辑与(所有都必须匹配，断言才是 ok)
测试模式:预期结果，即填写指定的结果(可填写多个) 按钮[添加]、[删除] 是进行指定内容的管理。

3.1.3 实战案例

检查百度首页的请求响应中是否包含"百度一下，你就知道"。

1. 步骤一：添加百度的 HTTP Request,添加对应的 Response Assertion，添加查看结果树。

如下图所示：

2. 步骤二：在 Response Assertion 元件中添加对应配置，

如下图所示：

3. 步骤三：查看结果如图所示：断言成功。

3.2 Size Assertion（大小断言）

3.2.1 简介

在 JMeter 中，Size Assertion 是一种断言元件，用于验证服务器响应的内容的大小是否符合预期。Size Assertion 允许您检查返回的响应数据的大小是否在指定的范围内，以便在性能测试中验证响应的大小是否符合要求。

3.2.2 参数配置介绍

Apply to 选项默认即可，Main sample only(仅作用于父节点取样器)。
Response Size Field to Test:
- Full Response：完整响应
- Response Headers：响应头
- Response Body：响应的消息体，选择此项判断返回主题数据 Body 的大小
- Response Code：响应代码
- Response Message：响应信息
Size to Assert：
- size in bytes（字节大小）：设置要判断的数值，单位 bytes/kb
- Type of Comparison（比较类型）

3.2.3 实战案例

检查百度首页的请求响应的内容大小是否大于等于 2381。

1. 步骤一：添加百度的 HTTP Request,添加对应的 Size Assertion，添加查看结果树。

如下图所示：

2. 步骤二：在 Size Assertion 元件中添加对应配置

如下图所示：

3. 步骤三：查看结果如图所示：断言成功。

3.3 XPath Assertion（XPath 断言）

3.3.1 简介

XPath Assertion 是 JMeter 中的一种断言元件，用于验证 XML 或 HTML 响应的内容是否符合指定的 XPath 表达式。XPath 是一种用于在 XML 文档中定位和选择元素的语言，通过 XPath Assertion，可以使用 XPath 表达式来验证响应中的特定内容，例如检查特定元素、属性或文本是否存在或符合条件。

3.3.2 参数配置介绍

XML Parsing Options （XML 解析选项）
- Use Tidy：当需要处理的页面是 HTML 格式时，必须选中该选项；如果是 XML 或 XHTML 格式（例如 RSS 返回），则取消选中，默认是 quiet；
- Quiet 表示只显示需要的 HTML 页面，
- Report errors 表示显示响应报错，
- Show warnings 表示显示警告；
- Use Namespaces：如果启用该选项，后续的 XML 解析器将使用命名空间来分辨；
- Validate XML：根据页面元素模式进行检查解析；
- Ignore Whitespace：忽略空白内容；
- Fetch external DTDs：如果选中该项，外部将使用 DTD 规则来获取页面内容。引用名称：下一个请求要引用的参数名称，如填写 title，则可用${ var_regexp2}引用它。（一些 XML 元素具有属性，属性包含应用程序使用的信息，属性仅在程序对元素进行读、写操作时，提供元素的额外信息，这时候需要在 DTDs 中声明）
Xpath Assertion 用于填写 xpath 表达式，点击 Validate 验证其正确性，勾选 True if nothing matches 表示确认都不匹配,才会断言验证通过。

3.3.3 实战案例

检查百度首页的请求响应的内容包含 Xpath 表达式：//input[@id="kw"]

1. 步骤一：添加百度的 HTTP Request,添加对应的 XPath Assertion，添加查看结果树。

如下图所示：

2. 步骤二：在 Xpath Assertion 元件中添加对应配置

如下图所示：

3. 步骤三：查看结果如图所示：断言成功。

3.4 JSON Assertion（Json 断言）

3.4.1 简介

JSON Assertion 是 JMeter 中的一种断言元件，用于验证 JSON 格式的响应数据是否符合预期。在进行 API 接口性能测试时，通常会返回 JSON 格式的响应数据，通过 JSON Assertion，可以根据预定义的 JSON 断言规则来验证返回的 JSON 数据是否正确。

3.4.2 参数配置介绍

Assert JSON Path exists: 用于断言的 JSON 元素的路径(实际结果)
Additionally assert value: 如果想要用某个值生成断言,请选择复选框。
Match as regular expression 使用正则表达式断言。
Expected Value: 期望值 (期望结果)
Expect null: 如果希望为空，请选择复选框。
Invert assertion (will fail if above conditions met): 反转断言(如果满足以上条件则失败)

3.4.3 JSON与JSON Path的简单说明

（1）JSON（JavaScript Object Notation）是一种轻量级的数据交换格式。

JSON数据容易理解，便于阅读和编写，同时计算机也易于解析和生成，所以JSON有广泛的应用。JSON常用数据结构如下：

对象（object）格式

{"name": "zhanghe","sex": 1,"age": 25
}

数组（Array）格式

{"man": [{"name": "zhanghe","sex": 1,"age": 25},{"name": "zhangsan","sex": 0,"age": 28}],"women": [{"name": "sansan","sex": 1,"age": 25},{"name": "huanhuan","sex": 0,"age": 28}  ]
}

（2）JSONPath

我们经常用XPath来分析、转换以及由选择的从XML文档中提取数据，与XPath类似，JSONPath也可以方便的从JSON结构中发现和提取数据。

（3）JSONPath语法

JsonPath的语法相对简单，它采用开发语言友好的表达式形式，如果你了解类C语言，对JsonPath就不会感到不适应。

JsonPath语法要点：

$ 表示文档的根元素
@ 表示文档的当前元素
.node_name 或 ['node_name'] 匹配下级节点
[index] 检索数组中的元素
[start:end:step] 支持数组切片语法
* 作为通配符，匹配所有成员
.. 子递归通配符，匹配成员的所有子元素
(<expr>) 使用表达式
?(<boolean expr>)进行数据筛选

下表将列举所有支持的语法，并对XPath进行比较：

XPath	JsonPath	说明
`/`	`$`	文档根元素
`.`	`@`	当前元素
`/`	`.`或`[]`	匹配下级元素
`..`	`N/A`	匹配上级元素，JsonPath不支持此操作符
`//`	`..`	递归匹配所有子元素
`*`	`*`	通配符，匹配下级元素
`@`	`N/A`	匹配属性，JsonPath不支持此操作符
`[]`	`[]`	下标运算符，根据索引获取元素，XPath索引从1开始，JsonPath索引从0开始
`	`	`[,]`
`N/A`	`[start:end:step]`	数据切片操作，XPath不支持
`[]`	`?()`	过滤表达式
`N/A`	`()`	脚本表达式，使用底层脚本引擎，XPath不支持
`()`	`N/A`	分组，JsonPath不支持

注意：

JsonPath的索引从0开始计数
JsonPath中字符串使用单引号表示，例如:$.store.book[?(@.category=='reference')]中的'reference'

具体示例如下表：

下面是相应的JsonPath的示例，代码来源于JSONPath - XPath for JSON，JSON文档如下：

{"store": {"book": [{"category": "reference","author": "Nigel Rees","title": "Sayings of the Century","price": 8.95}, {"category": "fiction","author": "Evelyn Waugh","title": "Sword of Honour","price": 12.99}, {"category": "fiction","author": "Herman Melville","title": "Moby Dick","isbn": "0-553-21311-3","price": 8.99}, {"category": "fiction","author": "J. R. R. Tolkien","title": "The Lord of the Rings","isbn": "0-395-19395-8","price": 22.99}],"bicycle": {"color": "red","price": 19.95}}
}

接下来我们看一下如何对这个文档进行解析：

XPath	JsonPath	Result
`/store/book/author`	`$.store.book[*].author`	所有book的author节点
`//author`	`$..author`	所有author节点
`/store/*`	`$.store.*`	store下的所有节点，book数组和bicycle节点
`/store//price`	`$.store..price`	store下的所有price节点
`//book[3]`	`$..book[2]`	匹配第3个book节点
`//book[last()]`	`$..book[(@.length-1)]`，或 `$..book[-1:]`	匹配倒数第1个book节点
`//book[position()<3]`	`$..book[0,1]`，或 `$..book[:2]`	匹配前两个book节点
`//book[isbn]`	`$..book[?(@.isbn)]`	过滤含isbn字段的节点
`//book[price<10]`	`$..book[?(@.price<10)]`	过滤`price<10`的节点
`//*`	`$..*`	递归匹配所有子节点
你可以在JSONPath Online Evaluator站点进行验证JsonPath的执行效果。

3.4.4 实战案例

检查天气请求响应的 JSON 数据中，city 对应的内容是否为'北京'。

步骤一：添加天气的 HTTP Request,添加对应的 JSON Assertion，添加查看结果树。

如下图所示：

步骤二：在 JSON Assertion 元件中添加对应配置

如下图所示：

步骤三：查看结果如图所示：断言成功。

一、前言

二、常用的JMeter断言元件

1. 常用断言元件

2. 断言添加方式：

3. 查看断言结果

3.1 【断言结果】看断言结果

3.2【查看结果树】看断言结果

三、断言元件的详细介绍

3.1 Response Assertion（响应断言）

3.1.1 简介

3.1.2 参数配置介绍

3.1.3 实战案例

3.2 Size Assertion（大小断言）

3.2.1 简介

3.2.2 参数配置介绍

3.2.3 实战案例

3.3 XPath Assertion（XPath 断言）

3.3.1 简介

3.3.2 参数配置介绍

3.3.3 实战案例

3.4 JSON Assertion（Json 断言）

3.4.1 简介

3.4.2 参数配置介绍

3.4.3 JSON与JSON Path的简单说明

3.4.4 实战案例

相关文章：