JMeter接口测试之断言实现

￡神魔★判官ぃ 2023-10-05 08:59 33阅读 0赞

#### JMeter接口测试之断言实现 ####

*  前言
 *  1 断言是什么
 *  2 断言的实现
 *   *  2.1 响应断言
     *  2.2 JSON断言
     *  2.3 BeanShell断言
     *  2.4 大小断言&断言持续时间

## 前言 ##

下面是目前JMeter系列已有博文列表，持续更新中：

> 1.  [JMeter安装与接口测试入门][JMeter]
> 2.  [JMeter接口测试之断言实现][JMeter 1]
> 3.  [JMeter逻辑控制器][JMeter 2]
> 4.  [JMeter配置元件][JMeter 3]
> 5.  [JMeter操作Mysql数据库][JMeter_Mysql]
> 6.  [BeanShell Sampler与BeanShell断言][BeanShell Sampler_BeanShell]
> 7.  [JMeter Linux下执行测试][JMeter Linux]
> 8.  [JMeter自定义日志与日志分析][JMeter 4]

## 1 断言是什么 ##

什么是断言？在接口测试中，我们预设接口响应结果中会出现一个片段，我们称之为预期值，断言会在接口调用后尝试捕捉这个预期值，如果能捕捉到，则判定接口成功，否则判定接口为失败。用过loadrunner的朋友一定记得检查点这个概念，断言和检查点实质上是一样的。

为什么需要断言？因为JMeter默认接口响应码200即为成功：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center]  
其实，接口的业务并非成功。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 1]  
为了甄别接口是否实现业务上的成功，我们便需要引入断言。

## 2 断言的实现 ##

在取样器上右键–添加–断言，可以看到，JMeter提供了丰富的断言实现（**JMeter版本：5.1.1，下同**）![在这里插入图片描述][20200824211031814.png]

### 2.1 响应断言 ###

这大概是最常用的断言了。

创建方式：在线程组或者HTTP请求上右键–>添加–>断言–>响应断言，就创建了一个断言：

> 关于断言的作用域：在线程组上创建断言，则该断言对线程组下所有取样器生效，而在取样器上创建，则只对该取样器生效。

![在这里插入图片描述][20200825103003424.png]  
一般情况下，我们用默认配置即可。各个项目也简略解释一下。

*  Apply to：即应用范围，一般使用`Main sample only`模式。`Main sample`代表主请求，`Sub-samples`代表主请求下的子请求。
 *  测试字段（Field to test）：表示在何种内容中匹配预期字段，一般选择响应文本。
    
    1.  响应文本：接口的Response的全部数据
    2.  响应代码：取样器结果中的`Response code`，常见的有200（成功）、302（重定向）、404（不存在）、400（参数错误）、500（服务器错误）等。但当我们要验证404,501等http响应代码时，需要勾选 `ignore status`，因为当http响应代码为404、500时，JMeter会默认这个请求是失败的。
    3.  响应信息：取样器结果中的`Response message`
    4.  响应头：响应数据的`Response headers`
    5.  请求头：请求的`Request headers`
    6.  URL样本：有跟随重定向时，URL样本包含了请求的URL和重定向的URL，否则只包含请求URL。
 *  模式匹配规则（Pattern Matching Rules）：即响应数据与预期值的对比方式。
    
    1.  包括（Contains）：响应数据包含预期值（相当于String的contains方法），则判定接口成功。支持正则匹配。
    2.  匹配（Matches）： 用正则表达式匹配返回结果，且必须能匹配整个返回值，而不是返回值的一部分。
    3.  相等（Equals）：响应数据与预期值完全相同才判定接口成功。不支持正则表达式。
    4.  字符串（Substring）：与【包括】类似，但不支持正则匹配。
    5.  否（Not）：取反，也就是前面【包括】等判定结果为true，断言结果为false。反之，前面判定为false，断言结果为true。
    6.  或者（Or）：勾选此项后，可以设置多个预期值，只要有一项判定成功，则断言判定成功。
 *  测试模式（Patterns to test）：预期值表达式，可以是正则表达式，也可以是字符串。可以通过【添加】按钮添加一个或多个，有多个的话，不勾选【模式匹配规则】中的【或者】，则为并集模式，即全部匹配成功才断言成功。
 *  自定义失败消息（Custom failure message）：当判断返回值为错误的时候，自定义的失败消息会在断言结果中显示。

下面用看一个小例子。

请求百度：  
![在这里插入图片描述][20200825113753890.png]  
响应数据：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 2]  
在【百度一下】请求下添加响应断言：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 3]  
执行请求，查看结果树：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 4]  
结果被标红，接口判定为失败。可见，你预设的断言决定了接口是否被判定成功。把上面断言中的“百度两下”改为“百度一下”，再次执行，则接口判定为成功。

### 2.2 JSON断言 ###

JSON断言针对响应结果是`applicaton/json`格式的请求进行断言。  
![在这里插入图片描述][2020082511474412.png]  
在取样器下右键–>添加–>断言–>JSON断言，就创建了一个JSON断言，界面如下：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 5]

*  `Assert JSON PATH exists`：针对响应结果中特定字段进行提取的路径表达式。
 *  `Additionally assert value`：附加断言值，勾选此项后才能填写Expected value。
 *  `Match as regular expression`：作为正则表达式匹配。
 *  `Expected value`：预期值，这个值将与`Assert JSON PATH exists`提取到的值对比，一致则判定接口成功。

下面照例进行一个实例演示。

首先，创建一个Beanshell取样器模拟接口，返回JSON数据。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 6]

return "{\"code\":0,\"message\":\"操作成功\",\"data\":{\"student\":[{\"name\":\"zhangxu\",\"age\":18},{\"name\":\"zhoushuang\",\"age\":18},{\"name\":\"changhua\",\"age\":17}]}}";

在该取样器下添加JSON断言，照下图写入：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 7]

> 这里解释一下【JSON Path expression】的写法，首先$.这部分是固定写法，后面根据层级关系去逐级获取数据。
> 
> 1、$.data表示在JSON串以"data"为key获取value，也就是\{“student”:\[\{“name”:“zhangxu”,“age”:18\},\{“name”:“zhoushuang”,“age”:18\},\{“name”:“changhua”,“age”:17\}\]\}。  
> 2、$.data.student对应的是\[\{“name”:“zhangxu”,“age”:18\},\{“name”:“zhoushuang”,“age”:18\},\{“name”:“changhua”,“age”:17\}\]，因此要通过索引定位到数组中的具体对象，也就是$.data.student\[0\]获取到了\{“name”:“zhangxu”,“age”:18\}  
> 3、$.data.student\[0\].name就定位到了“zhangxu”这个值。

运行脚本，察看结果树显示接口成功。

如果我们把`Expected value`改为"zhangxu2"，再次运行，发现接口被判定失败：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 8]

### 2.3 BeanShell断言 ###

这种断言是应对复杂校验的利器，为什么这么说呢？因为BeanShell断言可以写较复杂的逻辑判断来对结果进行校验。

还以2.2中的模拟接口为例，创建一个Beanshell断言：  
![在这里插入图片描述][20200825152440772.png]  
运行脚本，察看结果树：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 9]  
当然，这只是一个简单的示例，更丰富的用法请见：[JMeter BeanShell Sampler与JMeter BeanShell断言][BeanShell Sampler_BeanShell]

### 2.4 大小断言&断言持续时间 ###

大小断言：判断响应结果选定部分的字节大小是否与预期的值相符。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 10]  
![在这里插入图片描述][20200825153706378.png]  
断言持续时间：判断接口的响应时间是否小于等于设定值。

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 11]  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 12]

[JMeter]: https://blog.csdn.net/mu_wind/article/details/91872112
[JMeter 1]: https://blog.csdn.net/mu_wind/article/details/108204489
[JMeter 2]: https://blog.csdn.net/mu_wind/article/details/91879280
[JMeter 3]: https://blog.csdn.net/mu_wind/article/details/92796646
[JMeter_Mysql]: https://blog.csdn.net/mu_wind/article/details/93312052
[BeanShell Sampler_BeanShell]: https://blog.csdn.net/mu_wind/article/details/93506974
[JMeter Linux]: https://blog.csdn.net/mu_wind/article/details/95733081
[JMeter 4]: https://blog.csdn.net/mu_wind/article/details/95752633
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center]: https://img-blog.csdnimg.cn/20200824210759863.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 1]: https://img-blog.csdnimg.cn/20200824210638759.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[20200824211031814.png]: https://img-blog.csdnimg.cn/20200824211031814.png
[20200825103003424.png]: https://img-blog.csdnimg.cn/20200825103003424.png
[20200825113753890.png]: https://img-blog.csdnimg.cn/20200825113753890.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 2]: https://img-blog.csdnimg.cn/20200825113837360.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 3]: https://img-blog.csdnimg.cn/20200825114144545.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 4]: https://img-blog.csdnimg.cn/20200825114243117.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[2020082511474412.png]: https://img-blog.csdnimg.cn/2020082511474412.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 5]: https://img-blog.csdnimg.cn/20200825125201487.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 6]: https://img-blog.csdnimg.cn/20200825142717441.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 7]: https://img-blog.csdnimg.cn/20200825142804443.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 8]: https://img-blog.csdnimg.cn/20200825143750912.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[20200825152440772.png]: https://img-blog.csdnimg.cn/20200825152440772.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 9]: https://img-blog.csdnimg.cn/20200825152533401.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 10]: https://img-blog.csdnimg.cn/20200825153646793.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[20200825153706378.png]: https://img-blog.csdnimg.cn/20200825153706378.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 11]: https://img-blog.csdnimg.cn/20200825153823265.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ_size_16_color_FFFFFF_t_70_pic_center 12]: https://img-blog.csdnimg.cn/20200825153841541.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L211X3dpbmQ=,size_16,color_FFFFFF,t_70#pic_center