python 无原生 baggage 类型，opentelemetry 中需用 set_baggage 手动设置字符串键值对，并显式注入 baggage header 才能跨服务传递；其与 span.attributes 语义不同，前者全局传播、后者仅限单 span。
Python 没有原生的 Baggage 类型，它不是标准库或常见框架中的正式概念——你遇到的大概率是 OpenTracing / OpenTelemetry 里的 baggage（小写），或是某个特定库（如 opentelemetry-sdk）中用于跨服务传递上下文键值对的机制。
OpenTelemetry 中 baggage 的正确设置方式
OpenTelemetry 的 baggage 是轻量级、跨进程传播的字符串键值对，不参与采样决策，也不被默认导出到后端。它常用于灰度标记、租户 ID、请求来源等“辅助上下文”场景。
- 必须用
set_baggage（非set_attribute）写入，且 key 和 value 都需是字符串 - 写入后需显式通过
get_current_span()获取当前 span 并调用add_event或直接透传给下游 HTTP header（如baggageheader） - 若用
requests发起 HTTP 请求，要手动注入：headers["baggage"] = baggage.to_header() - 注意：
baggage不会自动随tracing一起序列化；漏掉 header 注入，下游就收不到
from opentelemetry import baggage
from opentelemetry.baggage import set_baggage
<p>set_baggage("env", "staging")
set_baggage("user_id", "u-12345")</p><h1>这个 baggage 不会自动出现在 HTTP 请求头里</h1><h1>必须手动提取并塞进 headers
baggage 和 span.attributes 的关键区别
两者都存键值对，但语义和生命周期完全不同：
DBShop开源商城系统
下载
DBShop开源商城系统，使用PHP语言基于Laminas（Zendframework 3） + Doctrine 2 组合框架开发完成。可定制、多终端、多场景、多支付、多货币；严谨的安全机制，可靠稳定；方便的操作管理，节约时间；清晰的权限分配，责任分明；便捷的更新处理，一键搞定；丰富的插件市场，扩展无限。
-
span.attributes属于单个 span，只在该 span 生命周期内有效，导出时会带上，但不会跨服务传播 -
baggage是全局上下文的一部分，随 trace propagation 自动跨进程（前提是中间件/SDK 正确实现 baggage propagation） - 写错地方很常见：把本该用
baggage传递的灰度标识写成span.set_attribute("canary", "true")，结果下游完全感知不到 - 性能影响极小，但滥用（如塞大 JSON 字符串）会导致 HTTP header 膨胀，触发网关截断
Django / Flask 中自动注入 baggage 的陷阱
Web 框架本身不处理 baggage，需要手动从 request.headers.get("baggage") 解析并激活上下文。
立即学习“Python免费学习笔记（深入）”；
- OpenTelemetry 的
WsgiMiddleware或ASGIMiddleware默认不解析baggageheader，仅处理 traceparent/tracestate - 必须自己调用
baggage.parse_baggage_header(request.headers.get("baggage", ""))，再用baggage.set_baggage激活 - 若在中间件里忘了
context.attach()，后续代码调用baggage.get_baggage会返回空 - 异步视图（如 FastAPI）中，
baggage上下文不自动跨async def边界，需配合contextvars手动传递
真正容易被忽略的是：baggage 的传播依赖整个链路所有组件都支持 baggage header 的解析与转发——哪怕一个 Nginx 反向代理没配置 proxy_pass_request_headers on，或者某段 Go 微服务用了老版本 otel-go（v1.10 之前默认禁用 baggage），整条链路上的 baggage 就断了。这种问题很难 debug，因为不报错，只是“消失了”。
