gRPC客户端传metadata需用metadata.Pairs构造键值对并经grpc.CallOption注入，服务端用metadata.FromIncomingContext读取、grpc.SendHeader/grpc.SetTrailer写回，拦截器中须注意上下文区分与并发安全。
gRPC客户端怎么传metadata
客户端传 metadata 的核心是用 metadata.Pairs 构造键值对，再通过 grpc.CallOption 注入到 RPC 调用中。不是所有调用方式都支持，比如直接用 client.Method(ctx, req) 时，必须显式传入 grpc.Header() 或 grpc.Trailer() 才能触发传输（否则服务端收不到）。
-
metadata.Pairs只接受偶数个字符串参数，key1, value1, key2, value2，错位或奇数个会 panic - 键名自动转小写（如
"Auth-Token"→"auth-token"），服务端要用小写取值 - 二进制值需加
-bin后缀，例如"session-id-bin"，否则 gRPC 会当作 UTF-8 字符串处理，非 ASCII 内容可能被截断或报错 - 示例：
ctx = metadata.AppendToOutgoingContext(ctx, "user-id", "123", "role", "admin")<br>resp, err := client.GetUser(ctx, &pb.GetUserRequest{Id: "123"})
服务端怎么读取和写回metadata
服务端用 metadata.FromIncomingContext 拿客户端传来的 header，用 grpc.SendHeader 和 grpc.SetTrailer 写回。注意：header 必须在首次响应前发送，trailer 必须在 RPC 结束前设置，晚了就丢弃。
-
metadata.FromIncomingContext返回(md, bool)，第二个值为false表示没收到任何 metadata（不是空 map） - 用
md.Get("key")取值，返回[]string；单值场景建议用md.Get("key")[0]，但要先判空，否则 panic - 写 header 示例：
md := metadata.Pairs("server-timestamp", time.Now().UTC().Format(time.RFC3339))<br>grpc.SendHeader(ctx, md) - trailer 常用于传递审计信息或错误上下文，但 HTTP/2 trailer 不保证客户端一定能收到（尤其浏览器 gRPC-Web 网关会丢弃）
metadata 在拦截器里怎么安全操作
拦截器是统一处理 metadata 的合理位置，但容易踩两个坑：一是并发读写同一 metadata 对象，二是误把 client context 的 metadata 当作 server context 的来用。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 服务端拦截器里，
metadata.FromIncomingContext拿的是 client 发的；metadata.FromOutgoingContext是空的（还没写） - 客户端拦截器里，
metadata.FromOutgoingContext拿的是你刚 append 的；但修改它不会自动同步到后续调用，得用metadata.AppendToOutgoingContext显式更新 - 不要在多个 goroutine 里共享一个
metadata.MD并发修改——它不是线程安全的，应每次 copy 后操作：newMD := metadata.MD{}<br>for k, v := range md {<br> newMD[k] = v<br>}<br>newMD["trace-id"] = traceID
为什么有些 metadata 在服务端始终为空
最常见原因是客户端没正确注入 context，或者用了不支持 metadata 的调用方式（比如忽略返回的 err 导致 ctx 被丢弃）。另一个隐蔽原因是 gRPC 连接复用 + 流式 RPC 中，metadata 只在 stream 创建时传递一次，中间无法动态更新。
立即学习“go语言免费学习笔记（深入）”；
- 检查客户端是否真的把带 metadata 的 ctx 传给了 stub 方法（不是传了个新 context 或 nil）
- HTTP/2 层限制：metadata 键名不能含下划线（
_），会被 gRPC Go 库静默过滤，只留连字符（-）和字母数字 - 服务端用
log.Printf("md: %+v", md)打印整个 metadata，比逐个Get更容易发现空值是真没传还是取错了键 - 如果用 TLS + 自定义证书认证，某些代理（如 Envoy）默认不透传自定义 metadata，需显式配置
allow_passthrough或headers_to_add
