一、前言

在 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 参数配置介绍

1. Apply to 选项默认即可，Main sample only(仅作用于父节点取样器)。

2. 测试字段:要检查的项 (实际结果)

   • Text Response:来自服务器的响应文本。
   • Response Code:响应的状态码，例如:200。
   • Response Message:响应的信息，例如: OK。
   • Response Headers: 响应头部
   • Request Headers: 请求头部
   • Request Data:请求数据
   • URL 样本:请求 URL
   • Document(text): 响应的整个文栏
   • 忽略状态:忽略返回的响应状态码

3. 模式匹配规则:比较方式（校验规则）

   • contains（包括）:文本包含指定的正则表达式
   • Matches（匹配）:整个文本匹配指定的正则表达式
   • Equals（等于）:整个返回结果的文本等于指定的字符串（区分大小写）
   • substring:返回结果的文本包含指定字符串(区分大小写)
   • 否: 取反
   • 或者:如果存在多个测试模式，勾选代表逻辑或(只要有一个模式匹配，则断言就是 ok)，不勾选代表逻辑与(所有都必须匹配，断言才是 ok)

4. 测试模式:预期结果，即填写指定的结果(可填写多个) 按钮[添加]、[删除] 是进行指定内容的管理。

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 参数配置介绍

1. Apply to 选项默认即可，Main sample only(仅作用于父节点取样器)。

2. Response Size Field to Test:

   • Full Response：完整响应
   • Response Headers：响应头
   • Response Body：响应的消息体，选择此项判断返回主题数据 Body 的大小
   • Response Code：响应代码
   • Response Message：响应信息

3. 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 参数配置介绍

1. 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 中声明）

2. 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 数据中，city 对应的内容是否为'北京'。

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

如下图所示：

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

如下图所示：

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