开发改了接口，经常忘通知测试，有什么好的解决方案吗？

共 2521字，需浏览 6分钟

2023-08-24 17:19

不知道大家有没有同感，做接口测试麻烦的不是测试本身，而是接口它会变，更麻烦的不是接口变了，而是它变了而你不知道。等到你测完，开发才悠悠跟你说 ——“那个接口我改了点东西，你再看一眼哈”。

我那是看一眼的工作量吗？我得 review 一遍看影响到哪些接口，再根据影响到的接口，查看并修改对应的接口用例，调用链下游的用例，该改的改，改完再跑一次接口测试。

—— 这意味着已经做完的工作又要来推翻重来一遍，我本来已经干完活儿悠哉摸鱼了，现在得加班了，我那 40 米大刀已经举起来你看到了没？

吐槽归吐槽，但人真的不是精密的机器没法保证一直不出错。即便我们组内 “服务好下游，承接好上游，不拖后腿，不坑队友” 已经是共识了，在彼此工作量巨大的前提下，真的很难不会有沟通不及时、不到位的情况。何况即便即时通知了，变更仍旧会给测试带来不少的返工工作量。

有没有一种可能接口被改了测试能及时同步到数据，不用自己去扒拉新的接口文档？有没有一种可能接口改了用例也能顺便帮我一起改了，再顺便告知我有哪些地方需要调整的我再精准调整？

大佬有了 idea 会自己造轮子，而我，我会找现成的轮子。比对了几款国内外的接口测试和管理工具，目前最符合这个需求的是一款叫 Apifox 的国产接口调试、测试、文档管理工具。

Apifox 解决方案

捋一下当一个接口被改了，它被改动的地方可能有：

接口的入参和出参没有变化，只是接口内部的实现逻辑变化了
接口的入参被修改了，这个请求参数可能是必填的也可能是非必填的
接口的返回响应被改了

那么对应的，测试需要捋清楚自己哪些地方需要返工：

1. 修改了内部逻辑的接口，用例不需要改动，只需要重新执行一遍测试2. 接口的出参入参变化导致改接口的服务受影响，相关用例也需同步调整3. 各个接口间存在参数传递和调用关系，也可能受影响，用例需要排查调整

简单来说就是捋清楚哪些接口收到影响了，再去修改对应的用例。这些工作原本需要我们手动排查的，其实可以直接利用 Apifox 去实现。

Apifox 对此给出的解决方案是：

1. 当开发那改动了接口之后，测试这边一键同步，能直接同步到最新的接口文档2. 设置接口用例与接口绑定，当接口的请求参数和响应参数发生变化，接口用例也会同步更新到最新的接口数据，不需要人工修改接口用例3. 一键回放接口用例，对比返回的结果，如果报错或者返回的数据结构不对应，则告警；4. 接口设计时可以对返回响应进行约束，用例设计时也可以对接口返回进行断言，当接口响应发生变化，执行自动化接口测试会针对错误的地方给出提示。

以上都依托于 Apifox 的自动化测试功能，用 Apifox 怎么做自动化测试，大家可以去官网搜一下相关教程，我重点会放在 “接口变更” 要怎么处理这部分。

用 Apifox 怎么处理接口变更

用 Apifox 处理接口变更主要依赖于它的两大功能：1. 接口变更数据同步与接口用例自动更新

接口用例是在接口的基础上，修改请求 / 响应字段的值保存生成的。无论是接口的域名，路径，方法，请求参数，响应参数被修改，接口用例也能够一键步到最新的数据。2. 自动断言功能 Apifox 的自动断言功能不需要写脚本，对 Python 或 js 不熟悉也可以直接通过可视化界面填写参数。在生成的接口用例中，选择后置操作tab/断言；填写你要断言的对象，提取响应里的目标参数，并设置判断规则，校验实际返回与期望返回是否与预期一致。提取参数时通过 json path 表达式提取的，具体规则可以看下这个使用文档：JSON Path 介绍 | Apifox 使用文档