搜「接口自动化测试包括哪些」的人,多半是刚被安排搭一套测试,打开文档发现全是术语,不知道该从哪写起。这篇不铺概念,只回答三件事:一套接口自动化测试到底包含哪几层内容、每层按什么标准判断要不要做、以及什么情况下这套东西其实不该上。看完能列出一份自己的清单。
搜这个问题的人,多半是刚被安排搭一套接口自动化测试,打开文档发现全是术语,不知道该从哪写起。我先说句实在话:这事儿麻烦的地方不在工具选型,在于大部分人只做了其中一层,然后以为自己做完了。装个框架、跑通一个请求,就这。
换个说法:接口自动化测试不是「一个工具」,是一套分三层的东西——测什么、怎么跑、坏了谁管。三层里缺一层,这套东西迟早变成没人看的红绿灯。下面按这三层拆,每层都给判断标准和能直接动手的动作,最后说说什么情况下这套东西其实不该上。
它到底包括什么:三层,不是一个工具
第一层是检查项,也就是一条用例里到底校验什么。单接口的入参出参对不对、状态码是不是预期、字段类型有没有变、业务码是不是成功、鉴权失效时是不是正确拒绝、同一个请求重复提交会不会出问题。这些是内容,不是框架。
第二层是运行方式:用例怎么组织、测试数据怎么准备、开发环境和测试专用环境怎么切换、是定时跑还是提交代码就触发、跑完报告给谁看。第三层是维护机制,接口改了谁去改用例、失败结果怎么分流、废用例多久清一次。三层都有人负责,才算搭起来了。
| 层次 | 包含什么 | 只做这一层的后果 |
|---|---|---|
| 检查项 | 出入参、状态码、字段类型、业务码、鉴权失效、幂等重复提交 | 用例写了不少,但漏掉真正会出线上问题的路径 |
| 运行方式 | 用例组织、数据准备、环境切换、触发方式、报告产出 | 只能在自己电脑上跑,一进流水线就失败 |
| 维护机制 | 接口变更后谁改、失败怎么分流、废用例多久清 | 失败率一高,团队集体不看了 |
哪些接口值得自动化,按风险排不按数量排
新手最常见的动作是照着接口文档挨个写,写完一看覆盖率很好看,真出问题的那几个接口反而没覆盖到。该按风险排,不按数量排。
优先做三类:被多个上游调用的公共接口,它一挂一片都挂;涉及金额或权限的写接口,出错的后果最重;历史上真出过线上问题的那几个,重复踩坑的成本最高。剩下的接口,排进来之前先想一下失败后果有多重。
- 把接口按调用频次、失败后果、变更频率各打一档,三档里有两档高的先做
- 变更频率高到一周改三次的模块,先别急着写,写了也是白写
- 界面还在天天改的原型阶段,接口契约不稳定,自动化用例的维护成本高于收益
- 公共接口和历史事故接口优先,这两类做完了再谈覆盖率
这里的「不适用」要说清楚:原型阶段、契约不稳的模块、还没定稿的接口,都不适合自动化。不是这些接口不重要,是这时候写用例的投入收不回来。
数据和环境这两块最容易卡住
第一次上手,十有八九卡在数据和环境上,而不是卡在写断言。测试数据要能自动造、自动清,否则跑第二遍就失败。常见误判是把生产上导出的一份数据当固定夹具,字段一改,整套用例全挂,而且你还得挨个查是数据问题还是代码问题。
环境上至少区分开发环境和测试专用环境。别让自动化用例把同事正在联调的库写脏,这种事出一次,团队对这套东西的信任就没了。
- 先做一次连通性检查用例开始前先请求一个健康检查或最简单的公共接口,确认环境和网络通,不通就直接报环境问题,不要跑完一堆再猜。
- 数据自动造自动清每条用例自带造数逻辑和清理逻辑,跑完不留脏数据;需要固定夹具的,标注清楚依赖哪个数据集。
- 地址只留一份环境地址放环境变量或配置里,用例里不要硬编码另一份地址,本地能过流水线失败,通常就是这里出的问题。
- 用例标注依赖为每条用例标清楚依赖的数据集和环境,跑失败时第一眼能判断是环境、数据还是代码。
跑起来之后,维护才是主要工作量
很多人以为跑通就结束了,实际跑起来之后,维护才是主要工作量。失败结果先分三类:真 bug、用例过期(接口改了用例没改)、环境抖动。三类混在一起报,失败率一高,团队就集体不看了,这套东西等于白搭。
还有件事得做:定期清理。连续多轮都因为接口下线而失败的用例,直接删,不要留着充数。用例数量好看没用,能信的失败才有用。
判断标准也给你:一套用例的失败里,如果超过一半是用例自身的问题,说明该停下来修用例,而不是继续加新用例。这时候加得越多,信任掉得越快。
什么情况下这套东西不该上?接口还在天天变、没有独立测试环境、没人愿意认领维护,三条里占两条,先别上。硬上就是给自己造一个没人看的报告。想看看别家怎么处理接口和工具这块,到站内工具目录翻一翻;接口资料和模型情况,去站内资料库核对当时的数字。
下一步先照着三层列一份自己的清单,再决定从哪层开始补。工具和资料别自己猜,到站内工具目录和资料库对照着看,能省掉不少返工。→常见问题
接口自动化测试就是写脚本调接口吗?
不全是。调接口只是检查项那一层,还得有稳定的用例组织、数据准备和失败处理。只写脚本不管维护,通常跑两三周就没人看了。
小团队有必要做接口自动化吗?
看接口是否稳定。如果接口契约基本定型、又有多处上游依赖,做一层冒烟用例很值;如果还在频繁改结构,先用手工和联调顶一段更划算。
它和性能测试是一回事吗?
不是。接口自动化关心结果对不对,性能测试关心同一时刻能扛多少。两者可以用相近的工具,但目标、数据准备和通过标准完全不同,别混成一套。