1. 课程导论：什么是API事务边界治理，为什么需要契约测试，课程目标与学习路径

1.1 什么是API事务边界治理

在微服务架构中，一个业务操作往往跨越多个服务，形成分布式事务。API事务边界治理是指：在服务间API交互的接口层面，明确界定每个事务的起始、终止、补偿与隔离范围，确保跨服务数据一致性与业务完整性。

事务边界治理的核心挑战来自微服务的去中心化特性：

• 网络不可靠：请求可能超时、重试或丢失，导致部分服务提交而部分回滚。
• 数据所有权分散：每个服务拥有独立数据库，无法使用传统数据库的ACID事务。
• API契约不一致：服务间对请求/响应结构的理解偏差，导致事务状态错乱。

1.2 为什么需要契约测试

契约测试（Contract Testing）是一种验证服务间API交互是否符合双方约定的测试方法。在事务边界治理中，契约测试的价值体现在三个层面：

1.3 事务边界治理中的契约测试架构

下图展示了契约测试在微服务事务边界治理中的位置与交互关系：

1.4 课程目标

完成本课程后，你将能够：

1. 理解事务边界治理的核心概念：掌握分布式事务在API层面的设计原则，包括幂等性、补偿、超时与状态机。
2. 掌握契约测试工具链：熟练使用Pact、Spring Cloud Contract、Postman Contract Test等工具，在开发环境中编写、验证和发布契约。
3. 搭建契约测试开发环境：配置本地Docker服务编排、契约桩服务、CI流水线，实现“契约即文档、契约即测试”。
4. 将契约测试嵌入事务治理流程：在API设计阶段定义事务契约，在开发阶段通过契约测试驱动实现，在CI阶段自动校验事务边界一致性。
5. 解决实际治理问题：通过契约测试发现并修复事务ID丢失、补偿接口不匹配、幂等键缺失等典型问题。

1.5 学习路径

本课程共30章，分为五个阶段，建议按顺序学习：

1.6 课程中的关键术语

为便于后续章节学习，先统一以下核心术语的定义：