Go 的 metadata.Map 类型中，键对应的值是 []string 类型（字符串切片），而非 string；直接将其传给只接受 string 参数的函数（如 data.Add）会导致类型不匹配错误，需显式索引或安全判空后取值。

go 的 metadata.map 类型中，键对应的值是 `[]string` 类型（字符串切片），而非 `string`；直接将其传给只接受 `string` 参数的函数（如 `data.add`）会导致类型不匹配错误，需显式索引或安全判空后取值。

在 Go 的 google.golang.org/grpc/metadata 包中，metadata.MD（常简写为 metadata.Map）底层是一个 map[string][]string —— 即每个 header 键映射到一个字符串切片，而非单个字符串。这是为了兼容 HTTP/2 多值头部语义（例如同一 header 名可出现多次）。因此，当你执行 headers["auth"] 时，返回的是 []string，即使你只设置了空字符串 ""，它也会被存为 []string{""}。

例如，以下代码会触发编译错误：

headers := metadata.Pairs("auth", "") // 等价于 metadata.New(map[string]string{"auth": ""})
token := headers["auth"]               // token 类型为 []string
data.Add("cookie", token)              // ❌ 编译失败：cannot use token (type []string) as type string

✅ 正确做法取决于业务逻辑对缺失/多值的容忍度：

• 若确定 auth 至少有一个值且只需首项（最常见场景）：

  

  Golang Uber Dig

  使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

  下载

  if len(token) > 0 {
      data.Add("cookie", token[0])
  }

• 若可接受空字符串作为默认值（简洁但隐含假设）：

  data.Add("cookie", "")
  if len(token) > 0 {
      data.Add("cookie", token[0])
  }

• 更健壮的封装建议（推荐用于生产环境）：

  func getFirstValue(md metadata.MD, key string) string {
      if vals := md[key]; len(vals) > 0 {
          return vals[0]
      }
      return ""
  }
  
  // 使用
  data.Add("cookie", getFirstValue(headers, "auth"))

⚠️ 注意事项：

• 不要使用 token[0] 而不检查长度，否则运行时 panic（index out of range）；
• metadata.Pairs 和 metadata.New 均生成 []string 值，无例外；
• 若需传递多个 auth 值（如 Bearer + Token），应明确设计协议并遍历切片，而非强制转 string。

总之，理解 metadata.Map 的 []string 语义是正确操作 gRPC 元数据的关键——它不是 bug，而是为协议兼容性所做的刻意设计。