1. Context Propagation 概述

1.1 定义：什么是 Context Propagation？

Context Propagation（上下文传播）是指在分布式系统的多个服务、线程或进程之间，透明地传递与请求关联的隐式元数据（即上下文）的机制。这些元数据通常包括追踪标识符（Trace ID、Span ID）、认证凭据、租户信息、优先级标记、流量标签等，它们不属于业务请求的显式载荷，但对系统的可观测性、安全性和治理至关重要。

在 RPC 框架中，Context Propagation 的核心职责是：在客户端发起调用时自动注入上下文，在服务端接收请求时自动提取上下文，并确保上下文在异步回调、线程切换或消息投递过程中不丢失、不污染。

1.2 核心价值：为什么需要 Context Propagation？

Context Propagation 为分布式系统提供了三大核心价值，缺一不可：

1.3 在分布式系统中的重要性

现代分布式系统通常由数十甚至数百个微服务组成，一次用户请求可能跨越 5~15 个服务节点。如果没有 Context Propagation，每个服务将处于“信息孤岛”状态，以下问题将变得不可控：

• 调用链断裂：无法将一次请求在不同服务中的日志、指标、异常关联起来，故障定位时间从分钟级恶化到小时级。
• 安全漏洞：用户认证信息只在入口网关生效，内部服务无法验证调用者身份，容易遭受 SSRF 或内部越权攻击。
• 治理失效：灰度流量标签、优先级标记在第一个服务之后丢失，导致全链路灰度或流量调度策略无法执行。
• 异步丢失：在消息队列、定时任务或线程池异步处理场景中，上下文无法自动传递，导致追踪和认证信息丢失。

下图展示了在一次典型的跨服务调用中，Context Propagation 如何串联起完整的请求生命周期：

1.4 上下文传播的挑战

在 RPC 框架中集成 Context Propagation 并非简单的“复制粘贴”，需要解决以下工程挑战：

1. 线程模型差异：同步调用、异步回调、响应式编程、协程等不同线程模型下，上下文存储和传递机制完全不同。
2. 协议兼容性：HTTP/2、gRPC、Thrift、Dubbo 等协议对元数据的承载方式各异（Header、Attachment、Metadata 等）。
3. 性能开销：每次 RPC 调用都涉及上下文的序列化/反序列化，必须控制在微秒级，避免成为瓶颈。
4. 安全边界：上下文可能包含敏感信息（如 ），传播过程中需要支持加密、裁剪或脱敏。
5. 向后兼容：旧版本客户端或服务端可能不支持上下文传播，框架需要提供降级策略。

1.5 上下文传播的典型实现模式

在主流 RPC 框架中，Context Propagation 通常遵循以下实现模式：