聊一聊契约测试

发布时间：2025-11-04 17:05:13 来源：科技前瞻 作者：系统运维

一、聊聊什么是契约契约

如果从契约产生的阶段来说，现有资料表明最早要追溯到西周时期的测试《周恭王三年裘卫典田契》，将契约文字刻写在器皿上，聊聊就是契约为了使契文中规定的内容得到多方承认、信守，测试“万年永宝用”。聊聊所以订立契约的契约本身，就是测试为了要信守，就是聊聊对诚信关系的一种确立。诚信，契约是测试我国所固有的一种优良传统，也是聊聊延续了几千年的一种民族美德，在中国儒家的契约思想体系里，是测试伦理道德内容中的一部分。

《现藏于台北故宫博物院》

现实真的是那么美好吗?小时候的服务器托管价值观教育未能改变社会的现状，缺少契约精神的案例却比比皆是。

那么，契约真的要消失了吗?不尽然，在软件测试领域，我们又重新拾起了契约这把利器。

二、发展历程

接下来让我们回顾一下契约测试的起源和发展历程：

假设我们有这样一个场景：A团队负责开发API服务，B团队进行API调用消费服务。

为了保证API的正确性，我们会对外部系统的API进行测试(除非你100%相信外部系统永远正确和保持不变)，这很可能就会导致一个问题，当外部系统并不那么稳定或者请求时间过长时，就会导致我们的测试效率很低，并且稳定性下降。比如当外部API挂掉导致测试失败时，你并不能完全确信是API功能被更而改导致的失败还是运行环境不稳定导致的请求失败。

最初，解决这个问题的方案是构建测试替身(Test Double)，免费源码下载通过模拟外部API的响应行为来增强测试的稳定性和反应速度。实现手段是在测试环境中搭建一个模拟服务环境，通过设定一些请求参数来返回不同的响应内容，然后再被内部系统调用，来保证调用端的正确性。构建模拟环境时我们可以使用几种不同的测试手段，如Dummy，Fake，Stubs，Spies，Mocks等。可是，问题又来了，如果使用测试替身那如何能保证外部系统API变化时得到及时的响应，换句话说，当内部系统测试都通过的通过时，如何能保证真正的外部API没有变化?

一个比较简单的方式是部分测试使用测试替身，另外一部分测试定期调用真实的外部API，这样既保证了测试的运行效率、源码下载调用端的准确性，又能确保当真实外部系统API改变时能得到反馈。

是不是到这里就皆大欢喜了呢?

如果剧情到这里就结束的话，未免太过俗套。这个方案最大的缺陷在于API的反应速度，真实外部API的反馈周期过长，如果减少真实API测试间隔时间就又会回到文章最开始的两难境地。

那么如何解决这个问题呢?先来让我们剖析一下前面几种解决方案的共通点。

在上面的场景中，我们都是已知外部API功能来编写相应的功能测试，并且使用直接调用外部API的方式来达到验证测试的目的，这样就不可避免的带来两个问题：

解决方式首先是依赖关系的解耦，去掉直接对外部API的依赖，而是内部和外部系统都依赖于一个双方共同认可的约定—“契约”，并且约定内容的变化会被及时感知;其次，将系统之间的集成测试，转换为由契约生成的单元测试，例如通过契约描述的内容，构建测试替身。这样，依赖契约的测试效率优于集成测试，同时契约替代外部API成为信息变更的载体。

对于契约来讲，行业内比较成熟的解决方案是基于YAML标记语言的Swagger Specification(OpenAPI Specification)，或者是基于JSON格式的Pact Specification。

通常的做法是API的提供者使用“契约”的形式，将功能发布在公共平台，给调用方进行说明和参考，这里我们可以暂时称之为Provider-Driven-Contract。这种做法的潜在问题是，功能提供方的API返回内容是否都满足所有API调用者的需求不得而知。所以，针对这个问题，依赖关系再一次反转，契约测试就摇身一变成为了Consumer-Driven-Contract test(CDCT), 通过给API提供方提供契约的形式，来完成功能的实现。

难道CDCT成为了问题终结者吗?请听后面分解。

注： 契约测试其中一个的典型应用场景是内外部系统之间的测试，另一个典型的例子是前后端分离后的API测试，这里不做过多展开。

三、契约测试的维度

1. 测试覆盖范围对比(纵向)

2. 测试效率对比(横向)

环境依赖：

Pact官方给出的几个场景：

适用场景：

不适用的场景：

以上对比说明契约测试所要解决的问题是替代系统之间的集成测试，通过契约和单元测试的方式加速系统运行。同时也说明契约测试存在一些不适用的场景，要依据使用场景区别对待。契约测试没有取代单元测试以及E2E测试。

四、契约测试与CD的整合

最开始，我们的pipeline是这样的，单元测试是独立的测试，当通过单元测试后运行集成测试。此时集成测试成为了系统瓶颈，而且一旦集成测试失败，就必须被迅速修复，其他pipeline只能等待其修复，否则任何新的变更都会测试失败。

一个解决办法是将集成测试分散在每个pipeline上，每次集成测试运行的版本是当前的最新代码和其他系统的上一次通过版本之间的测试。这样解决了测试的独立性以及不会阻碍其他pipeline测试的效果，然后将通过测试的不同系统的package按照版本保存。但是这样一来，集成测试的缺点就更为明显提现出来，第一是系统部署时间长，每次集成测试需要运行同样的测试在不同pipeline上，增加了测试成本和反馈周期。

接下来，我们使用契约测试替代集成测试。这样有几点好处不仅解决了独立测试的目的，同时解决了集成测试慢和部署时间长等问题。

为了保证契约测试的正确性，契约文件由Consumer端生成，然后Provider端来实现API，我们使用CDCT来改造我们的pipeline。

我们先假设B系统希望A系统提供新功能，如果按照图中黄色步骤来提交的话，则会测试失败，原因在于此时，契约文件是最新的B-A.consumer.1.1.pact与之对应A-B.provider.1.0.jar不是最新的，所以测试失败。

按照图中步骤2运行，当提交A的pipeline时，当前版本的A已经升级到1.1，而契约文件还是1.0版本，没有break测试的情况下，最终将A-B.provider.1.1.jar提交到服务器上。

然后按照图中步骤3运行，A-B.provider.1.1.jar和B-A.consumer.1.1.pact完美契合，最终又将B-A.consumer.1.1.pact提交到服务器。所以，改成CDCT之后，虽然产生了一定的提交顺序依赖，但是带来的更多的好处是确保契约文件的产生是调用端提出，并且保证当前最新，确保系统的正确性。

喜欢思考的同学不难发现，CDCT存在自身的缺陷，一个简单的例子是当B存在一个已有的契约约束A的一个功能，当B需要A更新其API时，是先提交B的契约测试，还是更改A的功能到最新版本?其实二者都不可行。

解决办法万变不离其宗，就是大家熟悉的不能再熟悉的重构心法，由王建总结的十六字箴言：

我们分五步来完成API的更新：

至此，我们解决了API更新时如何保证契约测试的提交顺序，如果是删除API，则直接删除Consumer端的契约测试即可。

五、需要思考的问题

1. 如果并行测试的话，谁先提交成功的版本，另外一个测试是否要重新运行?

设想，当两个并行pipeline A和B，同时运行时，A中跑的是A1.1和B1.0，B中跑的是B1.1和A1.0的测试，假如双方均能通过各自的测试，但是新版本不兼容(A1.1和B1.1测试失败)，双方都将各自的新版本保留，这样就造成了存在相互不兼容的两个版本。目前解决方案是，人为制造一个“瓶颈”，保证同时只有一个契约测试在运行，保存的只有一个版本。

2. 契约测试可维护性如何?

构建契约测试类似于单元测试，并且在Pact的框架下十分方便维护。但是，测试框架本身还有一些问题，诸如，大小写敏感，空值验证，只有一份契约文件，契约测试分组等。

(以上是基于pact 1.0的实践，pact2.0使用了正则表达式以及TypeMatching等机制解决了验证“具体”值的问题，更多详细内容请关注pact官方文档)

六、结语

契约测试不是银弹，它不是替代E2E测试的终结者，更不是单元测试的升级换代，它更偏向于服务和服务之间的API测试，通过解耦服务依赖关系和单元测试来加快测试的运行效率。

【本文是专栏作者“ThoughtWorks”的原创稿件，微信公众号：思特沃克，转载请联系原作者】

戳这里，看该作者更多好文

相关文章