安全携带 trace_id 应通过 promise_type 显式托管上下文，避免依赖 thread_local；opentelemetry-cpp 的 CurrentContext() 在协程中失效因 TLV 不跨线程迁移；需手动传递 Context 并用 traced_awaitable 在 suspend/resume 中显式管理 SetCurrent()。
std::coroutine_handle 怎么安全携带 trace_id？
不能直接把 std::string 或自定义上下文对象塞进协程帧——C++20 标准没规定帧布局，也没提供通用扩展点。强行偏移写入会破坏 ABI 兼容性，不同编译器或优化等级下行为不一致。
正确做法是用 promise_type 显式托管上下文：
- 在
promise_type里声明std::string trace_id或span_context成员 - 重载
get_return_object()，让返回的协程对象（如task<T>）持有一个指向该promise_type的弱引用或原始指针（注意生命周期） - 调用方在
co_await前通过co_await with_context("abc123")这类包装器注入上下文
常见错误：试图在 await_suspend() 里从 std::coroutine_handle<void> 反向查 promise_type 地址——这需要知道确切偏移，不可靠。必须由 promise_type 自己暴露接口，比如加一个 context() 成员函数。
opentelemetry-cpp 的 context::CurrentContext() 为什么在协程里失效？
因为 context::CurrentContext() 底层依赖线程局部存储（thread_local），而协程可能跨线程调度（比如从 io_thread 切到 worker_thread），TLV 不随协程迁移。
立即学习“C++免费学习笔记（深入）”；
解决路径只有一条：手动传递，不依赖隐式上下文：
- 所有异步函数签名显式增加
const opentelemetry::context::Context& ctx参数 - 每个
co_await点之后，用opentelemetry::context::Context::GetCurrent()拿不到你想要的值，得靠上游传入的ctx调用opentelemetry::context::Context::WithSpan()构造新上下文 - 避免使用
Tracer::StartSpan()的无参重载——它会读 TLV，结果是空 span
性能影响：每次 WithSpan() 是浅拷贝，开销可忽略；但若高频创建子 span，建议复用 Context 对象而非反复构造。
如何让 co_await 之后自动恢复 span 上下文？
不能靠编译器自动做，必须自己实现一个可等待体（awaitable），在 await_suspend() 和 await_resume() 中桥接 OpenTelemetry 上下文。
实操要点：
- 定义
struct traced_awaitable { opentelemetry::context::Context ctx; std::coroutine_handle<> resume_handle; }; -
await_suspend()里调用opentelemetry::context::Context::SetCurrent(ctx)，并记录当前 span 状态（比如是否已结束） -
await_resume()里再调用一次SetCurrent()恢复原上下文（注意：不是恢复“之前那个”，而是恢复调用方传来的ctx） - 关键坑：
SetCurrent()是线程级操作，如果 awaitable 被多个协程共享（比如 static 变量），会导致上下文污染——每个 awaitable 实例必须独占自己的ctx
示例片段：
co_await traced_awaitable{current_ctx, std::coroutine_handle<>::from_address(this)};
std::jthread + co_await 混用时 trace_id 丢失怎么办？
根本原因是 std::jthread 启动新线程后，旧线程的 thread_local 上下文不会自动继承，而协程恢复点又可能落在新线程上。
必须切断对隐式上下文的依赖：
- 启动
std::jthread时，显式把当前opentelemetry::context::Context作为参数传入 lambda - 在线程入口立即调用
opentelemetry::context::Context::SetCurrent()注入 - 协程挂起前，确保所有 span 已结束或已 detach；不要让 span 生命周期跨线程边界
- 避免在
jthread内部再起协程却不传ctx——这是最常漏掉的一环
容易被忽略的是：OpenTelemetry C++ SDK 的 Span 默认启用 defer ending，即析构时不自动 finish，而是等 scope exit。跨线程时这个 scope 很可能永远不退出，导致 span 卡住不上报。
