如何正确使用Go语言的context.WithValue进行链路追踪实践？

本文共计850个文字，预计阅读时间需要4分钟。

它仅适合传递固定范围的、不可变的元素，例如用户+ID、追踪+ID、请求+ID。通过它存储配置、数据库连接或可变状态等，等于把context当全局变量用，过早出口问题。

• 值必须是线程安全的；如果传了 map 或 slice，下游并发修改会引发 panic 或数据错乱
• key 类型强烈建议用自定义未导出类型（如 type userIDKey struct{}），避免字符串 key 冲突 —— 两个包都用 "user_id" 当 key，后塞的值会覆盖前一个
• 不要用 int、string 等基础类型做 key，Go 官方文档明确警告过类型冲突风险

链路追踪中传 traceID 的标准写法

OpenTracing / OpenTelemetry 生态里，context.WithValue 是透传 traceID 和 span 的底层手段，但你不该自己拼接 key 或手动生成字符串。