第1章：SDK调用链路概述
咱们做性能优化的，第一个要搞明白的就是——调用链路到底是什么。
说白了，一次 SDK 调用，从你的 App 发出请求，到拿到结果返回，中间经过了多少环节？每个环节花了多少时间？哪个环节是瓶颈？这些信息串起来，就是一条调用链路。
我个人习惯把调用链路比作快递物流。你寄一个包裹，从收件、分拣、运输、再到派送，每个节点都有记录。SDK 调用也一样，从发起请求、序列化、网络传输、服务端处理、再到响应返回，每一步都需要被记录和追踪。
1.1 什么是调用链路
来看个具体场景。你的 App 调用了某个广告 SDK 获取广告位信息。这个调用背后发生了什么？
- 客户端：App 调用 SDK 接口，SDK 构建请求参数，发起网络请求
- 网络层：DNS 解析、建立连接、TLS 握手、数据传输
- 网关：请求到达服务端网关，进行路由、鉴权、限流
- 业务服务：广告引擎处理请求，查询策略、匹配广告
- 数据存储：访问 Redis、MySQL 等存储系统
这整个链条中的每一次调用、每一次处理，就构成了一个完整的调用链路。我在项目中遇到过最夸张的一个案例，一个简单的 SDK 初始化接口，底层居然串联了十几个微服务调用。不画链路图，根本看不出问题在哪。
| 环节 | 典型耗时 | 常见瓶颈 |
|---|---|---|
| 客户端构建请求 | 0.1-1ms | 对象序列化、参数校验 |
| DNS解析 | 10-100ms | 缓存命中率低 |
| TLS握手 | 20-200ms | 证书链验证、会话复用 |
| 网络传输(RTT) | 10-100ms | 带宽、距离、丢包 |
| 网关处理 | 1-5ms | 路由计算、限流判断 |
| 业务逻辑 | 5-100ms+ | 算法复杂度、外部依赖 |
| 数据存储 | 1-10ms | 缓存未命中、慢查询 |
1.2 全链路追踪基础
全链路追踪，就是给每一次请求分配一个唯一 ID，然后把这个 ID 传遍整个调用链路上的所有节点。
你想想看，没有这个 ID，你怎么把分属于不同服务的日志关联起来？你只知道服务 A 花了 50ms，服务 B 花了 30ms，但这两次调用是不是同一个请求触发的？没法判断。
业界主流的全链路追踪标准是 OpenTelemetry（以前叫 OpenTracing + OpenCensus）。它定义了三个核心概念：
- Trace：一条完整的调用链路，由多个 Span 组成
- Span：一次具体的操作单元，比如一个 RPC 调用、一次数据库查询
- SpanContext：包含 Trace ID 和 Span ID 的上下文信息，负责在节点间传递
全链路追踪的典型流程是这样的：
- 客户端发起请求时，生成一个 Trace ID
- 每次调用下游服务时，创建一个子 Span，继承当前 SpanContext
- 将 Span 的信息（开始时间、结束时间、状态、标签等）上报到后端
- 后端根据 Trace ID 将所有 Span 串联起来，重建完整调用链路
// 采集一个 Span 的典型数据
{
"traceId": "f8c7e5a1b2d3e4f5",
"spanId": "a1b2c3d4",
"parentSpanId": "e5f6a7b8",
"operationName": "AdSDK.fetchAd",
"startTime": 1735689600000,
"endTime": 1735689600050,
"status": "OK",
"tags": {
"sdk_version": "3.2.1",
"ad_slot_id": "slot_001",
"network_type": "wifi"
}
}
1.3 链路标记与传播
链路标记，就是在 Span 上打标签。这玩意儿特别有用。
我举个例子。你在 SDK 里加了缓存逻辑，但不确定缓存到底有没有生效。你在关键路径上打两个标记：一个是「缓存命中」，一个是「缓存未命中」。上线一看链路数据，一目了然。
标记传播，就是把这些标记信息跟着请求一起走，从一个服务传到下一个服务。
常见的传播方式有两种：
- HTTP 头部传播：通过自定义 HTTP Header 传递 Trace ID 和 Span ID，比如
X-Request-Id、traceparent - 进程内传播：通过线程局部变量（ThreadLocal）或协程上下文传递 SpanContext
// HTTP 头部传播示例
// 客户端发送请求时
String traceId = SpanContext.current().getTraceId();
String spanId = SpanContext.current().getSpanId();
request.setHeader("traceparent", "00-" + traceId + "-" + spanId + "-01");
// 服务端接收请求时
String traceparent = request.getHeader("traceparent");
String[] parts = traceparent.split("-");
String traceId = parts[1];
String spanId = parts[2];
下面这张图，把本章的核心概念串起来了。
这张图展示了从用户请求到链路追踪上报的完整流程。根 Span 负责全局协调，子 Span 记录每个环节的细节。所有 Span 最终汇聚到后端，按 Trace ID 重组。