📚 课程目录第2章核心概念

2. 核心概念：什么是契约测试、数据校验、回归冒烟测试，以及三者之间的关系

在构建数据库缓存工程时，数据在“数据库 → 缓存 → 应用”之间的流转必须保持精确一致。任何环节的偏差都可能导致脏读、缓存穿透或数据不一致。本章围绕三个核心概念展开：契约测试、数据校验、回归冒烟测试，并阐明它们如何协同驱动数据校验方案。

2.1 契约测试（Contract Testing）

契约测试是一种轻量级的集成测试策略，用于验证服务间或组件间的交互是否符合预先定义的“契约”。在数据库缓存场景中，契约通常指缓存层与数据库层之间的数据格式、字段约束、超时策略和异常处理协议。

  核心思想：不依赖完整环境，通过“消费者驱动”的契约文件，验证提供者是否满足调用方的期望。

维度	说明	缓存工程示例
消费者	调用缓存接口的服务（如订单服务）	期望缓存返回完整的用户对象，包含 id、name、email
提供者	缓存中间件或缓存封装层	保证序列化后的 JSON 字段名、类型与契约一致
契约文件	YAML/JSON 格式的交互描述	定义请求 key 格式、响应结构、状态码、TTL 范围
验证方式	模拟请求 + 断言响应	使用 Pact 或 Spring Cloud Contract 在 CI 中执行

// 契约示例（Pact JVM DSL）
@Pact(consumer = "order-service")
public V4Pact createCachePact(PactDslWithProvider builder) {
    return builder
        .given("缓存中存在用户ID 1001")
        .uponReceiving("获取用户缓存数据")
            .path("/cache/user/1001")
            .method("GET")
        .willRespondWith()
            .status(200)
            .headers(Map.of("Content-Type", "application/json"))
            .body(new PactDslJsonBody()
                .integerType("id", 1001)
                .stringType("name", "张三")
                .stringType("email", "zhangsan@example.com"))
        .toPact();
}

2.2 数据校验（Data Validation）

数据校验是对数据完整性、准确性、一致性和时效性进行自动化检查的过程。在缓存工程中，数据校验不仅发生在写入时，更关键的是在缓存与数据库同步的每个节点上。

缓存数据校验的三大维度：

结构校验：字段类型、嵌套层级、枚举值范围是否与契约一致。
一致性校验：缓存中的值与数据库源值是否逻辑等价（如经过聚合、脱敏后仍可溯源）。
时效性校验：TTL 是否合理、过期后是否触发正确的回源策略。

校验类型	校验工具/方法	缓存场景示例
JSON Schema 校验	everit-json-schema / NetworkNT	验证缓存中的用户对象包含必填字段
字段值校验	断言框架（AssertJ / Hamcrest）	缓存中的金额字段不能为负数
交叉校验	数据库查询 + 缓存查询对比	缓存中的商品库存与 MySQL 行记录一致
时间戳校验	比较 lastModified 与缓存写入时间	缓存数据未超过 TTL 且未落后于数据库更新

// 数据校验示例：缓存对象 vs 数据库源
public void validateCacheConsistency(CacheUser cacheUser, DbUser dbUser) {
    // 结构校验
    assertThat(cacheUser).isNotNull();
    assertThat(cacheUser.getId()).isEqualTo(dbUser.getId());
    // 一致性校验：缓存中的脱敏手机号应与数据库源匹配
    assertThat(cacheUser.getMaskedPhone())
        .isEqualTo(maskPhone(dbUser.getPhone()));
    // 时效性校验：缓存版本不能低于数据库版本
    assertThat(cacheUser.getVersion())
        .isGreaterThanOrEqualTo(dbUser.getVersion());
}

2.3 回归冒烟测试（Regression Smoke Testing）

回归冒烟测试是每次代码变更后，快速执行的一组最小化、高价值的测试用例，用于验证核心功能未被破坏。在缓存工程中，冒烟测试聚焦于缓存读写、失效、回源和一致性等关键路径。

注意：冒烟测试不是全量回归。它只覆盖“如果这里失败，整个缓存系统就不可用”的路径。全量回归应放在后续的集成测试阶段。

冒烟测试项	预期结果	失败影响
缓存写入后立即读取	返回写入的值	缓存基本读写功能失效
缓存过期后读取	触发回源，返回数据库最新值	缓存穿透或脏数据
缓存删除后读取	返回 null 或触发回源	缓存与数据库不一致
批量缓存失效	相关 key 全部不可用	缓存雪崩风险

// 冒烟测试示例（JUnit 5 + Redis）
@Test
@DisplayName("冒烟：缓存写入后读取应一致")
void smokeTest_cacheWriteAndRead() {
    String key = "smoke:user:1001";
    String value = "{\"id\":1001,\"name\":\"张三\"}";
    redisTemplate.opsForValue().set(key, value, Duration.ofMinutes(5));
    String cached = redisTemplate.opsForValue().get(key);
    assertThat(cached).isEqualTo(value);
    redisTemplate.delete(key);
}

2.4 三者关系：契约测试驱动数据校验，数据校验支撑回归冒烟

这三个概念并非孤立存在，而是形成一条从定义到验证再到持续保障的链条：

契约测试 在开发阶段定义并验证缓存接口的“法律条文”。它确保消费者和提供者对数据格式达成共识。
数据校验 在运行时和测试时对实际数据流进行逐字段检查。它把契约中的抽象约束转化为可执行的断言。
回归冒烟测试 将契约测试和数据校验的关键用例打包成快速验证集，在每次构建或部署前执行，确保核心链路不退化。