4. 实时校验架构总览：整体架构图、核心组件

实时校验架构的核心目标是在不影响业务吞吐量的前提下，对每一次缓存操作与数据库状态进行原子级比对，确保缓存与数据库的数据一致性。本章从全局视角出发，绘制整体架构图，并逐一拆解四大核心组件：API网关、缓存层、数据库层、校验引擎。

4.1 整体架构图

下图展示了实时校验架构的完整数据流与组件协作关系。所有外部请求首先经过API网关，网关负责流量分发与校验触发；校验引擎作为核心决策单元，协调缓存层与数据库层的读写校验；最终将校验结果反馈给网关或异步写入日志。

4.2 核心组件详解

实时校验架构由四个核心组件构成，每个组件承担明确的职责，并通过标准协议进行通信。下表总结了各组件的定位与关键特性：

组件	核心职责	关键特性	典型实现
API网关	请求入口、流量分发、校验触发	拦截写请求、解析OpenAPI参数、调用校验引擎	Kong / APISIX / 自研网关
缓存层	高速数据暂存、读写加速	TTL管理、缓存穿透/击穿防护、数据快照	Redis Cluster / Redis Sentinel
数据库层	持久化存储、事务保证	行级锁、MVCC、binlog订阅	MySQL 8.0 / PostgreSQL
校验引擎	一致性校验、差异检测、修复决策	实时比对、异步回查、阈值控制	自研校验中间件

4.3 API网关：校验触发的第一站

API网关是外部请求进入系统的唯一入口。在实时校验架构中，网关不仅承担路由和限流职责，还负责识别需要校验的OpenAPI接口，并将请求上下文传递给校验引擎。

• 请求拦截：根据OpenAPI路径、方法、参数匹配校验规则。
• 上下文传递：将请求ID、用户标识、操作类型、缓存键等信息封装为校验上下文。
• 结果处理：根据校验引擎返回的结果决定是否放行、降级或拒绝请求。

4.4 缓存层与数据库层：数据双存储

缓存层和数据库层构成数据存储的双支柱。缓存层提供微秒级读取，数据库层保证数据持久化与事务完整性。实时校验的核心就是在这两层之间建立可观测的一致性桥梁。

下表对比了缓存层与数据库层在实时校验场景下的关键差异：

对比维度	缓存层 (Redis)	数据库层 (MySQL)
读写延迟	1-5ms	10-50ms
数据一致性模型	最终一致性	强一致性 (ACID)
校验粒度	键值对级别	行级别
校验触发方式	主动查询 + 被动通知	binlog监听 + 快照比对
典型校验频率	每次写操作后立即校验	异步批量校验 (秒级)

4.5 校验引擎：架构的决策大脑

校验引擎是整个架构的核心决策单元。它接收来自API网关的校验请求，协调缓存层与数据库层的查询，执行一致性比对算法，并输出校验结果。

校验引擎的内部工作流程包含以下步骤：

1. 接收校验上下文：从API网关获取请求ID、缓存键、预期操作等。
2. 并行查询：同时向缓存层和数据库层发起数据查询。
3. 数据比对：比较缓存值与数据库值的字段级差异。
4. 决策输出：返回一致/不一致/超时/异常四种状态。
5. 异步修复：对不一致数据触发修复流程或写入校验日志。

4.6 组件协作流程

下图以一次典型的写操作为例，展示四个组件之间的完整协作时序：

4.7 架构设计要点总结

• 解耦性：校验引擎独立部署，不依赖任何业务服务，支持独立扩缩容。
• 可观测性：所有校验结果写入日志系统，支持实时监控和事后审计。
• 容错性：校验引擎超时或异常时，网关自动降级为“跳过校验”，保证业务可用性。
• 扩展性：支持通过插件机制增加新的校验规则，无需修改核心代码。