接口测试用例设计实践总结

设计思路

1)  优先级--针对所有接口

1、暴露在外面的接口，因为通常该接口会给第三方调用；

2、供系统内部调用的核心功能接口；

3、供系统内部调用非核心功能接口；

2)  优先级--针对单个接口

1、正向用例优先测试,逆向用例次之(通常情况，非绝对)；

2、是否满足前提条件 > 是否携带默认参值参数 > 参数是否必填 > 参数之间是否存在关联 > 参数数据类型限制 >参数数据类型自身的数据范围值限制

3)  设计分析

通常，设计接口测试用例需要考虑以下几个方面：

1、是否满足前提条件

有些接口需要满足前置条件，才可成功获取数据。常见的，需要登陆Token。

逆向用例：

针对是否满足前置条件(假设为n个条件)，设计0~n条用例

2、是否携带默认值参数

正向用例：

带默认值的参数都不填写、不传参，必填参数都填写正确且存在的“常规”值，其它不填写，设计1条用例；

3、业务规则、功能需求

这里根据实际情况，结合接口参数说明，可能需要设计n条正向用例和逆向用例

5、参数是否必填

逆向用例：

针对每个必填参数，都设计1条参数值为空的逆向用例

4、参数之间是否存在关联

有些参数彼此之间存在相互制约的关系

逆向用例：

根据实际情况，可能需要设计0~n条用例

5、参数数据类型限制

逆向用例：

针对每个参数都设计1条参数值类型不符的逆向用例

6、参数数据类型自身的数据范围值限制

正向用例：

针对所有参数，设计1条每个参数的参数值在数据范围内为最大值的正向用例

逆向用例：

针对每个参数(假设n个)，设计n条每个参数的参数值都超出数据范围最大值的逆向用例

针对每个参数(假设n个)，设计n条每个参数的参数值都小于数据范围最小值的逆向用例

以上几个方面考虑全的话，基本可以做到如下几个方面的覆盖：

主流程测试用例：正常的主流程功能校验；

分支流测试用例：正常的分支流功能校验。

异常流测试用例：异常容错校验

4)  编写描述

尽量逻辑化，这样方便后续的维护

5)  实践操作

接口样例

获取订单列表接口（多条件）

获取店铺指定期间的所有订单列表(多种条件组合)，默认根据日期倒序排序。

接口方向

客户端 ->

接口协议

接口地址：$xxx_Home/xxx/鉴权前缀/xxxxx/getAllOrderList

接口协议：JSON

HTTP请求方式：GET

消息请求

字段列表如下：

字段名

数据类型

默认值

必填项

备注

shopId

int


是

商铺编号

token

string


条件

设备令牌。Token鉴权方式必填

dateType

int

1

否

订单查询时间字段。

1：下单时间（order_time）

2：订单完成时间（order_finish_time）

3：结算时间（shop_settle_time）

startDate

date


是

查询日期

endDate

Date


否

查询结束日期。

orderStatus

String


否

订单状态。

不填表示所有状态

多个状态之间以英文逗号分割

0:已预定

1:已开单

2:派送中

3:已完成（原已结帐）

4:退单中

5:已退单

8:自助下单

9:待确认

orderTransactionType

Int


否

订单交易状态。

不填表示所有。

1:未完成，

2:已完成(3:已完成, 5:已退单)

payType

int


否

支付方式。

不填表示所有。

1:现金

2:POS

3:线上

cashierId

int


否

收银员

billerId

int


否

导购员

pNo

int


否

页码,从第1页开始，默认为1

pSize

int


否

每页记录数，默认为10

消息请求样例：


?shopId=1111111111&token=123411nmk515155&queryDate=2015-10-10


消息响应

字段元素如下：

字段名

数据类型

默认值

必填项

备注

orderTotalPriceTotal

double


是

实收金额合计（已完成的合计）

platformTotalIncomePriceTotal

double


是

平台服务费合计

cashPayTotal

double


否

现金支付（已完成的合计）

posPayTotal

double


否

POS支付（已完成的合计）

onLinePayTotal

double


否

线上支付（已完成的合计）

lst

object


是

明细列表

明细列表对象字段元素定义：

字段名

数据类型

默认值

必填项

备注

orderId

string


是

订单ID

orderTitle

string


是

订单标题

mobile

string


否

会员账号,如果是会员则显示手机号，为空时表示“非会员”

settlePrice

double


是

交易金额

orderTime

datetime


是

下单时间

serviceAmount

double


是

平台服务费

Status

Int


是

订单状态。

0:已预定

1:已开单

2:派送中

3:已完成（原已结帐）

4:退单中

5:已退单

8:自助下单

9:待确认

cashPay

double


否

现金支付

posPay

double


否

POS支付

onLinePay

double


否

线上支付

成功时，返回JSON数据包：


{
  
  查询订单列表成功！",
  
      
      
      orderTotalPriceTotal": 23.3,
      platformTotalIncomePriceTotal": 0,
      
          
              
              
              
              
              
              
               "orderId": "12345679282015092913440268141",
              
          
          
              红塔山",
              
              
              
              
              
               "orderId": "12345679282015092911370588273"
          
      
  }
}


用例设计



存在问题：

如上，还没写完就有40几条用例了，要是接口参数再多点，接口数量再增加点，工作量可想而知，所以，问题来了，咋办呢？

个人见解：

1、根据接口的使用对象(外部，系统内部)，有选择的去、留部分用例

2、根据接口的是否核心接口，有选择的去、留部分用例

3、根据参数说明，及实际情况，有选择的去、留部分用例

实例：

上例这个接口，是供app、商铺后台调用的，且为系统内部调用，所以，以下用例可酌情略去：

test-E-按商铺id查询-商铺id非int型

test-E-按设备token查询-token非string类型

test-E-按订单时间类型查询-时间类型非int型

test-E-按起始日期查询-时间类型非date型

test-E-按结束日期查询-时间类型非date型

test-E-按订单状态查询-订单状态非string类型

test-E-按交易状态查询-交易状态非int型

test-E-按支付方式查询-支付方式非int值

test-E-按收银员查询-收银员id非int值

test-E-按导购员查询-导购员id非int值

test-E-按页码查询-页码非int值

理由：

这个接口是给其它开发于系统内部调用的，开发过程中，开发者肯定需要调用这些接口，如果类型错了，他们也就获取不到预期的数据，这些错误，他们肯定可以发现，所以，他们传递的参数值一般能保证类型正确。

test-N-按参数类型最大值查询   所有参数

test-E-按商铺id查询-商铺id超过类型范围值

test-E-按订单状态查询-订单状态值超过类型最大值

test-E-按交易状态查询-交易状态值超过int类型最大值

略去的用例部分（参数值超过类型最大值）

理由：

1、内部调用，参数值不是外部手动输入的，输入数据长度、值大小可控，当然如果数据一直增长，那再大的类型可能都无法保证不超出，比如自动增长的商铺id

2、部分参数的参数值是自定义的，比如 订单时间类型，就那几种，除非传错了，不然不可能超出范围

最后简化后的用例数差不多28条，如果是手工测试，对于正向用例，根据等价类原理，可以制造一条数据，覆盖多条用例，当然，也可以冗余处理，即一条用例一条数据，这样的好处就是每次的验证点比较单一一点，比较有针对性。

问题

如果是自动化测试呢，这里是设计一个方法覆盖多条用例呢(如上，一条数据，覆盖多条用例)？还是一个方法覆盖一条用例呢？

我个人的答案是一个方法一条用例，你的呢？