架构与系统设计 / 系统课时

测试体系建设

测试体系建设

支付平台的测试目标不只是“接口返回成功”,而是验证状态变化、外部契约、重复回调和账务结果始终正确。本课将设计分层测试体系,并用资金守恒测试演示如何把核心业务规则变成可自动执行的断言。

学习目标

  • 能划分单元测试、集成测试、契约测试和端到端测试的职责边界
  • 能设计支付回调、幂等和异常场景的自动化验证
  • 能使用资金守恒与账实一致断言保护核心账务逻辑

建立分层测试模型

测试越靠近代码,执行越快、定位越准;越接近真实链路,覆盖越完整、维护成本越高。合理做法不是只追求端到端测试,而是让不同层次各自验证最适合的问题。

支付平台分层测试体系

测试类型 主要验证内容 推荐运行时机
单元测试 费率、状态机、路由、幂等判断等纯业务规则 每次提交
集成测试 数据库事务、缓存、消息队列、唯一约束 合并请求与持续集成
契约测试 商户接口、内部接口、渠道请求与响应字段 接口或版本变更时
回调测试 验签、乱序、重复、延迟、伪造通知 每次发布前
端到端测试 下单到支付、退款、记账和通知的完整主链路 发布候选版本

上层测试不能替代下层测试。例如端到端用例发现“退款金额错误”时,定位成本很高;相同规则若有单元测试,失败位置会直接指向计算逻辑。

资金正确性主示例

支付账务常用的核心约束是借贷平衡:同一业务事件生成的分录金额之和应为零。下面给出一个可运行的 JUnit 5 测试,使用整数分表示金额,避免浮点误差。项目的 pom.xml 至少需要以下测试依赖:

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。

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, "同一支付事件的分录合计必须为零");
    }
}

执行测试:

bash
mvn test -Dtest=LedgerBalanceTest

预期输出

text
Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
BUILD SUCCESS

实际耗时和日志前缀可能不同,但测试结果必须为 1 个用例通过。类似断言还应覆盖退款、部分退款、手续费退还、冲正和重复消息,确保任何路径都不会造成余额凭空增加或减少。

集成与契约测试

集成测试应使用与生产一致的数据库类型,并验证真实事务和约束,而不是只模拟 Mapper。重点场景包括重复请求只能落一条订单、消息消费失败会回滚、事务提交后才发送通知,以及并发更新不会突破可退款金额。

契约测试关注字段和语义是否稳定。对商户开放接口,应固定请求必填项、状态码、错误码和响应结构;对渠道接口,应保存经过脱敏的典型报文作为契约样本。字段新增通常可以向后兼容,删除字段、改名或改变枚举语义必须触发失败。

Tips:Mock 只适合隔离不可控依赖,不应把数据库事务、唯一索引和消息确认机制全部 Mock 掉,否则测试会绕过最容易出故障的部分。

回调与异常场景

回调测试不能只覆盖一次成功通知。至少要验证正确签名、错误签名、重复通知、先失败后成功、超时后补发、金额不一致和订单不存在。断言重点是业务状态只能按允许方向迁移,重复回调不重复记账,也不重复通知商户。

回调接口还应在并发条件下测试。可以同时发送多次相同通知,最终只允许一条状态变更记录和一组账务分录;其他请求应返回幂等成功或明确的可重试结果,而不是抛出不可控异常。

持续集成与质量门禁

持续集成流水线可分为三个阶段:提交阶段运行快速单元测试,合并阶段运行数据库和消息中间件集成测试,发布阶段运行契约、回调与少量端到端用例。失败用例必须阻止进入下一阶段。

覆盖率只能作为辅助指标,不能替代关键场景清单。支付平台更应关注核心状态迁移、资金分录、幂等键、异常补偿和接口契约是否被断言。一个覆盖率较高但没有资金断言的测试集,仍然可能放过严重缺陷。

验收标准

测试体系完成后,应能对一次普通支付、一次重复下单、一次通道超时、一次重复回调、一次部分退款和一次账务异常给出自动化结果。每个失败都应指向明确层次,而不是只能依赖人工查看整条链路。

发布前还应保存测试报告、失败日志和契约差异,便于审计与回溯。生产事故对应的根因必须沉淀为永久回归用例,防止相同问题再次出现。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

测试体系建设

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通