架构与系统设计 / 系统课时
测试体系建设
测试体系建设
支付平台的测试目标不只是“接口返回成功”,而是验证状态变化、外部契约、重复回调和账务结果始终正确。本课将设计分层测试体系,并用资金守恒测试演示如何把核心业务规则变成可自动执行的断言。
学习目标
- 能划分单元测试、集成测试、契约测试和端到端测试的职责边界
- 能设计支付回调、幂等和异常场景的自动化验证
- 能使用资金守恒与账实一致断言保护核心账务逻辑
建立分层测试模型
测试越靠近代码,执行越快、定位越准;越接近真实链路,覆盖越完整、维护成本越高。合理做法不是只追求端到端测试,而是让不同层次各自验证最适合的问题。

| 测试类型 | 主要验证内容 | 推荐运行时机 |
|---|---|---|
| 单元测试 | 费率、状态机、路由、幂等判断等纯业务规则 | 每次提交 |
| 集成测试 | 数据库事务、缓存、消息队列、唯一约束 | 合并请求与持续集成 |
| 契约测试 | 商户接口、内部接口、渠道请求与响应字段 | 接口或版本变更时 |
| 回调测试 | 验签、乱序、重复、延迟、伪造通知 | 每次发布前 |
| 端到端测试 | 下单到支付、退款、记账和通知的完整主链路 | 发布候选版本 |
上层测试不能替代下层测试。例如端到端用例发现“退款金额错误”时,定位成本很高;相同规则若有单元测试,失败位置会直接指向计算逻辑。
资金正确性主示例
支付账务常用的核心约束是借贷平衡:同一业务事件生成的分录金额之和应为零。下面给出一个可运行的 JUnit 5 测试,使用整数分表示金额,避免浮点误差。项目的 pom.xml 至少需要以下测试依赖:
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>5.11.4</version>
<scope>test</scope>
</dependency>将测试保存为 src/test/java/com/example/payment/LedgerBalanceTest.java。
package com.example.payment;
import org.junit.jupiter.api.Test;
import java.util.List;
import static org.junit.jupiter.api.Assertions.assertEquals;
class LedgerBalanceTest {
record Entry(String account, long amountInCent) {
}
static List<Entry> buildPaymentEntries(long amountInCent, long feeInCent) {
// 商户应收、平台手续费与渠道待结算必须共同保持借贷平衡
return List.of(
new Entry("merchant_receivable", amountInCent - feeInCent),
new Entry("platform_fee", feeInCent),
new Entry("channel_clearing", -amountInCent)
);
}
@Test
void paymentEntriesShouldBeBalanced() {
List<Entry> entries = buildPaymentEntries(10_000, 60);
long total = entries.stream()
.mapToLong(Entry::amountInCent)
.sum();
assertEquals(0, total, "同一支付事件的分录合计必须为零");
}
}执行测试:
mvn test -Dtest=LedgerBalanceTest预期输出
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS实际耗时和日志前缀可能不同,但测试结果必须为 1 个用例通过。类似断言还应覆盖退款、部分退款、手续费退还、冲正和重复消息,确保任何路径都不会造成余额凭空增加或减少。
集成与契约测试
集成测试应使用与生产一致的数据库类型,并验证真实事务和约束,而不是只模拟 Mapper。重点场景包括重复请求只能落一条订单、消息消费失败会回滚、事务提交后才发送通知,以及并发更新不会突破可退款金额。
契约测试关注字段和语义是否稳定。对商户开放接口,应固定请求必填项、状态码、错误码和响应结构;对渠道接口,应保存经过脱敏的典型报文作为契约样本。字段新增通常可以向后兼容,删除字段、改名或改变枚举语义必须触发失败。
Tips:Mock 只适合隔离不可控依赖,不应把数据库事务、唯一索引和消息确认机制全部 Mock 掉,否则测试会绕过最容易出故障的部分。
回调与异常场景
回调测试不能只覆盖一次成功通知。至少要验证正确签名、错误签名、重复通知、先失败后成功、超时后补发、金额不一致和订单不存在。断言重点是业务状态只能按允许方向迁移,重复回调不重复记账,也不重复通知商户。
回调接口还应在并发条件下测试。可以同时发送多次相同通知,最终只允许一条状态变更记录和一组账务分录;其他请求应返回幂等成功或明确的可重试结果,而不是抛出不可控异常。
持续集成与质量门禁
持续集成流水线可分为三个阶段:提交阶段运行快速单元测试,合并阶段运行数据库和消息中间件集成测试,发布阶段运行契约、回调与少量端到端用例。失败用例必须阻止进入下一阶段。
覆盖率只能作为辅助指标,不能替代关键场景清单。支付平台更应关注核心状态迁移、资金分录、幂等键、异常补偿和接口契约是否被断言。一个覆盖率较高但没有资金断言的测试集,仍然可能放过严重缺陷。
验收标准
测试体系完成后,应能对一次普通支付、一次重复下单、一次通道超时、一次重复回调、一次部分退款和一次账务异常给出自动化结果。每个失败都应指向明确层次,而不是只能依赖人工查看整条链路。
发布前还应保存测试报告、失败日志和契约差异,便于审计与回溯。生产事故对应的根因必须沉淀为永久回归用例,防止相同问题再次出现。