1. 课程导论：OpenAPI 迁移背景、缓存冒烟检查的重要性、集成测试整体目标
1.1 OpenAPI 迁移背景
随着微服务架构的普及和 API 网关的演进，越来越多的企业将传统 RESTful 接口规范迁移至 OpenAPI 3.x 标准。迁移的核心驱动力包括：
- 标准化契约：OpenAPI 提供机器可读的接口描述，支持自动生成客户端 SDK、服务端桩代码和文档。
- 多版本兼容：从 Swagger 2.0 迁移至 OpenAPI 3.x，解决参数定义、请求体描述、安全方案等语义歧义。
- 工具链升级：新版本适配现代 API 网关（如 Kong、APISIX）、流量管理平台和契约测试框架。
- 缓存策略重构：迁移过程中，原有基于 URI + Query 的缓存键规则可能因 OpenAPI 路径参数、Header 参数定义变化而失效。
关键风险：OpenAPI 迁移后，缓存层是第一个暴露问题的环节。接口路径、参数名、响应结构的变化会直接导致缓存穿透、缓存雪崩或数据不一致。
1.2 缓存冒烟检查的重要性
缓存冒烟检查是迁移后集成测试的第一道防线。它并非全量缓存功能回归，而是针对缓存基础设施和核心缓存逻辑的快速验证。其核心价值体现在：
| 检查维度 | 冒烟检查项 | 迁移后典型问题 |
|---|---|---|
| 缓存键生成 | 新 OpenAPI 路径 + 参数组合能否正确生成缓存键 | 路径变量名变更导致键冲突或键缺失 |
| 缓存命中/未命中 | 相同请求是否返回缓存数据，不同请求是否隔离 | Header 参数未纳入键计算导致数据错乱 |
| 缓存过期与淘汰 | TTL 设置是否生效，LRU/LFU 淘汰是否正常 | 迁移后响应体增大导致内存溢出或淘汰策略失效 |
| 缓存与源站一致性 | 缓存数据与直接查询源站的数据是否一致 | 响应字段重命名后缓存未刷新，返回旧字段 |
注意：缓存冒烟检查失败时，应立即阻断后续集成测试。因为缓存层异常会污染后续所有依赖缓存数据的测试用例，导致误报和排查成本剧增。
1.3 集成测试整体目标
本课程设计的集成测试体系，围绕 OpenAPI 迁移后的缓存稳定性，设定以下三层目标：
- 快速反馈：在 CI/CD 流水线中，缓存冒烟检查应在 3 分钟内完成，覆盖核心读写路径。
- 契约对齐：确保缓存行为与 OpenAPI 规范中定义的缓存策略（Cache-Control、ETag、Vary）完全一致。
- 故障隔离：当缓存组件（Redis/Memcached/Local Cache）出现故障时，测试能明确区分是缓存自身问题还是迁移引入的兼容性问题。
下图展示了 OpenAPI 迁移后缓存冒烟检查在集成测试中的整体定位与流程：
1.4 课程知识体系
本课程共 30 章，按以下模块组织：
| 模块 | 章节范围 | 核心内容 |
|---|---|---|
| 基础篇 | 第 1-5 章 | OpenAPI 迁移原理、缓存策略分析、冒烟检查设计模式 |
| 工具篇 | 第 6-12 章 | Postman/Newman、JMeter、K6 脚本编写与断言 |
| 实战篇 | 第 13-22 章 | Redis/Memcached 冒烟检查、缓存键冲突检测、一致性校验 |
| 进阶篇 | 第 23-28 章 | 分布式缓存、多级缓存、缓存故障注入与混沌工程 |
| 收尾篇 | 第 29-30 章 | CI/CD 集成、报告生成、最佳实践总结 |
学习建议：如果你是第一次接触缓存冒烟检查，建议从基础篇开始，重点理解缓存键生成规则和冒烟检查的通过/失败阈值定义。实战篇的代码示例可直接复制到本地环境运行。