【JMeter-2】JMeter接口测试之断言实现

JMeter接口测试之断言实现

1 断言是什么

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

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

其实，接口的业务并非成功。

为了甄别接口是否实现业务上的成功，我们便需要引入断言。

2 断言的实现

在取样器上右键–添加–断言，可以看到，JMeter提供了丰富的断言实现（JMeter版本：5.1.1，下同）

2.1 响应断言

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

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

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

一般情况下，我们用默认配置即可。各个项目也简略解释一下。

• 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）：当判断返回值为错误的时候，自定义的失败消息会在断言结果中显示。

下面用看一个小例子。

请求百度：

响应数据：

在【百度一下】请求下添加响应断言：

执行请求，查看结果树：

结果被标红，接口判定为失败。可见，你预设的断言决定了接口是否被判定成功。把上面断言中的“百度两下”改为“百度一下”，再次执行，则接口判定为成功。

2.2 JSON断言

JSON断言针对响应结果是applicaton/json格式的请求进行断言。

在取样器下右键–>添加–>断言–>JSON断言，就创建了一个JSON断言，界面如下：

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

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

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

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

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

这里解释一下【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.student0获取到了{“name”:“zhangxu”,“age”:18} 3、$.data.student0.name就定位到了“zhangxu”这个值。

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

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

2.3 BeanShell断言

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

还以2.2中的模拟接口为例，创建一个Beanshell断言：

运行脚本，察看结果树：

当然，这只是一个简单的示例，更丰富的用法请见：JMeter BeanShell Sampler与JMeter BeanShell断言

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

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

断言持续时间：判断接口的响应时间是否小于等于设定值。