4. 测试链路概念：什么是测试链路、链路追踪的基本单元（Span）、Trace与Span的关系

在分布式系统与缓存一致性测试中，测试链路是贯穿多个服务、中间件与数据层的完整请求路径。理解测试链路的基本概念，是设计采样策略与一致性校验的前提。本节从三个层次展开：测试链路的定义、链路追踪的基本单元（Span）、以及 Trace 与 Span 的层级关系。

4.1 什么是测试链路

测试链路是指一次业务请求或数据操作在分布式环境中经过的所有组件、服务与网络跳转的完整路径。在缓存一致性测试场景中，测试链路通常包含：

• 入口服务：接收用户请求或测试脚本的网关/API 服务
• 业务服务：执行核心逻辑，如订单、库存、用户服务
• 缓存层：Redis / Memcached 等缓存组件
• 数据库层：MySQL / PostgreSQL 等持久化存储
• 消息队列：异步更新缓存或数据同步的中间件

测试链路的可视化呈现，能够帮助工程师快速定位缓存不一致的根因——例如，是缓存更新失败、数据库回滚未通知缓存，还是消息队列消费顺序错乱。

4.2 链路追踪的基本单元：Span

Span 是分布式链路追踪中最小的、不可分割的工作单元。每个 Span 代表一个操作片段，例如一次数据库查询、一次缓存读取、一次 RPC 调用或一个消息发送。

一个标准的 Span 包含以下核心属性：

4.3 Trace 与 Span 的关系

Trace 是由多个 Span 组成的、代表一次完整请求或事务的树状结构。Trace 与 Span 的关系可以概括为：

• 一个 Trace 包含一个或多个 Span：最简单的 Trace 只有一个 Span（单服务同步调用），复杂的 Trace 可能包含数百个 Span（微服务网状调用）。
• Span 通过 Parent-Child 关系形成树：根 Span（Root Span）没有父 Span，代表请求的入口；子 Span 代表下游调用或并行操作。
• 所有 Span 共享同一个 Trace ID：这是将分散的 Span 关联到同一请求的关键标识。
• Span 的嵌套深度反映调用层级：深度越深，表示调用链越长，潜在的性能瓶颈或一致性风险点越多。

下面通过一张 SVG 结构图展示 Trace 与 Span 的层级关系，以及 Span 之间的 Parent-Child 连接：

4.4 测试链路中的 Span 生命周期

在 OpenTelemetry 中，Span 的生命周期包含以下阶段，每个阶段都与缓存一致性测试的特定操作对应：

1. Span 开始：记录操作名称、开始时间戳、初始属性（如缓存 key 名称）。
2. 添加事件：在 Span 执行过程中记录关键事件，例如“缓存未命中，回源数据库”。
3. 设置属性：动态添加键值对，例如 cache.version=2、db.row_count=1。
4. 设置状态：操作完成后标记 OK 或 ERROR，ERROR 状态通常触发采样策略的调整。
5. Span 结束：记录结束时间戳，Span 被导出到后端存储。

4.5 Trace 与 Span 的对比总结