你写的接口脚本合理么

谈到自动化测试，或者说接口测试，大家关注更多的是哪个工具更优秀，更好用。但是很少人关注到接口测试用例的设计问题，也很少人会去写接口用例，都代码化了嘛，还写什么用例，是吧。这样真的是对的么？我们是不是忽略了什么呢？回归测试的时候，成百上千个接口执行下来，没有报错，你就真的对系统放心了么？在接口测试之外，我们还需要补充哪些功能用例来验证那些接口做不了或者不好做的场景呢？

个人认为，除开脚本层面的编写外，接口用例的设计也是一项非常重要的测试活动。通过一定的接口用例设计，让我们编写的脚本更有目的性、更可靠，才能体现接口测试的价值的意义，而不是单纯以量取胜。“测试目的明确，符合接口测试基本原则，断言清晰的接口自动化脚本才是好脚本“

01

某个用例的测试目的是什么

在进行接口测试脚本的编写前，我们应该明确这批脚本的预期目标在哪里，是为了验证什么内容。根据个人的经验，一般会把接口用例分成三类：

• 单接口验证：以验证接口参数、权限、返回值为主，保证接口“能用”，这类用例一般在接口设计定稿后，配合Mock服务就可以完成用例编写；
• 场景逻辑验证：以用户场景为基础，验证接口间的参数传递及业务流程能够正常流转，用例复杂度较高，需要非常熟悉业务与接口之间的关系。这是接口测试最核心的价值。
• 异常验证：主要验证参数异常、逻辑异常等情况下，接口是否能处理并给出友好的错误信息。通常情况下，关注参数异常的场景会比较多，可以用等价类、边界值等方式来处理。需要注意的是多关注下异常的返回信息是什么，信息是否明确，提示是否友好等等。

02

接口信息的来源

当我们明确好测试目标后，再开始编写测试用例，会有更针对性的去设计测试数据和接口组合。接下来的问题是什么呢？去哪里确认你的接口信息是有效的？基本上有两种路径：

• 接口文档：开发人员都不喜欢自己写文档，同时也很讨厌别人不写文档。所以测试人员如何获取一份真实有效的接口文档是件比较麻烦的事。般团队内都会有一个统一的接口文档管理工具（如果没有，就找开发多磨麿，让他们弄个，并不难），我们需要关注接口文档的有效性和及时性。现在也有很多的插件或者工具能够帮助研发人员自动生成接口文档，例如Swaager、apidoc等等。
• 接口抓包：如果什么都没有，那就自力更生，通过Fiddler之类的工具，通过抓包分析的方式来获取接口，这类的场景如果较多的话，可以把Fiddler抓到的接口导出，然后写个小程序，直接转成接口平台可以识别的脚本，效率会更高一些。

在获取到接口信息后，需要与开发人员多交流，明确参数的意义及来源，以便我们针对性的做测试用例设计，这个环节不要过多的自己猜（很多测试人员经常会自己猜想），直接找开发问就好了。在这个接段，还要梳理并区分接口的重要程度和优先级。这样就可以确认哪些接口优先设计用例，哪些接口可以先放放，在有限制的时间内，做最大价值的事。

03

一些基本原则

拿到接口后，明确了参数说明，结合测试目标，我们就可以开始设计并编写测试用例了。区别于功能测试用例，接口测试用例（脚本）一些原则需要注意：

• 自动化：好像是废话，所有的用例应该是非交互试，最常见的就是Token之类的生成，需自动处理好（我见过每次执行用例前，需要自己手动生成Token再粘贴进去的脚本，特别是分环境执行的时候）。
• 独立性：每个用例应该是独立的，没有依赖的。需要在一个用例里处理好前置条件，而不是多个用例相互依赖。
• 可重复：用例测试可重复执行，所以需要注意参数的生成方式。
• 可持续性：如果代码修改导致已有接口测试执行失败，必须修复代码问题或者测试代码逻辑。

04

断言那些事

在设计测试用例时，还需要关注的是针对断言的设计，好的断言能够帮助我们发现问题，没有断言的用例（脚本）就是耍流氓，完全没有意义。个人在审核脚本时，会重点关注这个（很多测试人员为了数据好看，或者因为是事后补写，所以断言写的非常简单，这类脚本其实都是在做无用功，纯粹是为了KPI）。从接口层面看，我们至少需要验证两点：

• 数据结构验证：验证接口返回的数据结构是否与事先定义的一样。调用方在处理数据时，肯定是根据事先定义好的数据结构来解析数据的，如果数据结构发生变化，那对调用方来说，是灾难性的（契约测试考虑下）。
• 核心数值的验证：根据业务场景的不同，可以有目的性的验证某些key的值是否与预期的一样，可以结合数据库查询的方式来验证（不同的自动化测试框架有不同的实现方式）。这个就比较依赖测试人员对业务的了解。根据实际情况灵活的设计验证点。

除了以上两点外，还有一些额外的验证点在需要的时候可以进行，如涉及到其它方的数据流转、返回的URL是否可被访问，返回的数据是否真的是必要的（这点很重要，过多的返回会导致很多意外的问题）等等。根据实际情况进行补充。

这样，通过一系列的方法设计出来的接口用例，才会有一定的业务价值，能够真正的帮助到团队，提升测试效率，对于这样的测试脚本，全部PASS的结果才会让人安心（你能想象没有断言的脚本全部PASS，你还放心的么）。

05

脚本的后期维护

测试用例（脚本）编写完成后，并不意味着接口测试的成完。在其它的测试环节中，如果发现因为接口问题而产生的BUG（如响应异常、无数据返回等情况），我们需要适当的补充到接口用例中，避免类似的情况再次发生而我们没有验证到。在积累到一定高质量的用例（脚本）后，可以进一步挖掘这些东西的价值，如转化成线上业务监控的脚本，转换成精准测试的依据等。还有更高端的玩法，是借助混沌测试的思路，独立拉个分支，故意修改一些异常出来，让测试用例验证，能否发现这些BUG，以验证测试用例的有效性。如果不能发现，那就需要我们去思考如何改进测试脚本（业内已经有类似的平台出现了）。

06

关于测试数据的准备

多聊下测试数据准备的事，这其实是接口测试中很重要的一个环节，想要脚本可以在多个环境中运行，那么测试数据就不能写的太死，需要根据环境去自动获取一些数据值。针对测试数据的准备，一般的玩法也有三类：

• 公共参数：通过不同作用域及标识的区分，有个专门的文件来处理一些共用数据的存放，例如不同环境下的用户名
• 数据集合：通过特定的API或者SQL事先生成所需要的数据，然后放到一个指定的集合（参数或者文件都可以）中，在需要的时候，从这里获取对应的数据值。
• 数据模板：这个是数据集合的升级版，根据业务数据流，只需要填写一些简单的信息，就可以自动生成一整套的业务数据（例如个人做过的，通过基础的学校信息，就自动生成一套针对性的数据，包含学校、班级、学科、学生等整套的数据）。

关于接口测试平台的研发，可以参考我的另一篇文章：

接口测试平台演进思考