C++微服务链路追踪核心是解决OpenTelemetry SDK与构建链、ABI、运行时上下文传播的兼容性问题：需强制C++17标准及统一GLIBCXX_USE_CXX11_ABI；HTTP/gRPC须手动注入traceparent；Span生命周期须绑定异步句柄而非TLS；Resource必须进程启动时静态注册。
直接说结论：C++微服务做链路追踪，核心不是“能不能”，而是“怎么让 OpenTelemetry C++ SDK 和你的构建链、ABI、运行时上下文传播不打架”。绝大多数编译失败、Span 丢失、traceparent 不透传，都卡在这三处。
cmake 配置必须显式启用 C++17 且禁用默认 ABI 版本切换
OpenTelemetry C++ SDK v1.9.1+ 强依赖 std::string_view、std::optional 和协程基础设施，GCC 9.3+/Clang 12+ 默认开启 -D_GLIBCXX_USE_CXX11_ABI=1，但很多金融/交易类项目仍链接旧 ABI 的 protobuf 或 gRPC。一旦混用，opentelemetry::trace::TracerProvider::GetTracer 构造时会因 vtable 偏移错乱而崩溃。
- 在根
CMakeLists.txt顶部强制统一 ABI：set(CMAKE_CXX_STANDARD 17)+set(CMAKE_CXX_STANDARD_REQUIRED ON)+add_compile_options(-D_GLIBCXX_USE_CXX11_ABI=1) - 若你必须兼容旧 ABI 库（如某定制版 gRPC），则整个项目（含 OpenTelemetry）需统一降级为
-D_GLIBCXX_USE_CXX11_ABI=0，且不能使用opentelemetry::common::KeyValue的移动构造——它在旧 ABI 下有已知 double-free 漏洞 - 验证方式：编译后执行
nm -C libopentelemetry_trace.so | grep TracerProvider | head -n1，输出中应含TracerProviderImpl而非乱码符号
HTTP 上下文传播必须手动注入 traceparent，不能只靠自动 Propagator
OpenTelemetry C++ 的 HttpTextMapPropagator 默认只处理 traceparent 和 tracestate，但 Crow.cpp、cpp-httplib 等轻量框架的 request/response 对象不提供标准 HeaderCarrier 接口。如果你直接调用 propagator->Inject 却没把 header 写进实际 HTTP 发送缓冲区，Span 就永远断在第一跳。
- 对 Crow.cpp，在路由 handler 中这样写：
req.add_header("traceparent", context_str);，其中context_str来自propagator->Inject的回调输出 - 对 gRPC 客户端，必须用
ClientContext::AddMetadata注入，而非依赖opentelemetry::exporter::otlp::OtlpGrpcExporterOptions—— 后者只管导出，不管跨服务传播 - 关键陷阱：OpenTelemetry C++ 的
traceparent格式是00-<trace_id>-<span_id>-01</span_id></trace_id>，但某些 Java 服务（尤其 Spring Boot 3.2+）会拒绝末尾带换行或空格的值。务必用absl::StripAsciiWhitespace或std::string::erase清理后再注入
Span 生命周期必须绑定到异步操作句柄，而非线程局部存储
C++ 微服务普遍用 std::coroutine 或 boost::asio::awaitable 处理高并发请求。但 OpenTelemetry C++ SDK 的默认 Scope 是基于 thread_local 实现的——一旦协程挂起后被调度到其他线程恢复，GetCurrentSpan() 就返回空，后续所有 RecordEvent 全部静默丢弃。
立即学习“C++免费学习笔记（深入）”；
- 正确做法：用
opentelemetry::context::RuntimeContext::Attach把当前context显式传入协程帧，例如：co_await async_call(..., current_context); - 更稳妥的是改用
opentelemetry::trace::Tracer::StartSpanWithOptions并传入SpanContext，避免依赖 Scope 的隐式绑定 - 验证是否生效：在 Span 结束前加一句
span->SetAttribute("debug.thread_id", std::this_thread::get_id());，对比日志里 thread_id 是否随协程迁移而变化
最常被忽略的一点：OpenTelemetry C++ 的 Resource（服务名、版本、主机信息）必须在进程启动时一次性注册，且不可更改。如果在某个 HTTP handler 里动态调用 Resource::Create 并试图覆盖全局 provider，Jaeger UI 里看到的服务名会是空字符串或随机哈希值——因为 exporter 已经按初始 Resource 初始化了连接池，后续修改完全无效。
