ASP.NET Core（三十一）关于 gRPC 元数据 Metadata 的获取

小渣渣

需求：当使用客户端传递元数据 Metadata 的时候，ASP.NET Core 服务端应该怎么获取呢？

元数据 Metadata 概述

元数据是一种旁路通道，允许客户端和服务器之间传递与 RPC 相关联的信息。

gRPC 元数据是与初始或最终 gRPC 请求或响应一起发送的键值对数据。它用于提供关于调用的额外信息，例如认证凭据、追踪信息或自定义头部。

gRPC 元数据使用 HTTP/2 头部实现。键是 ASCII 字符串，值可以是 ASCII 字符串或二进制数据。键不区分大小写，并且不能以 grpc- 前缀开头，该前缀是 gRPC 自身保留的。

gRPC 元数据可以由客户端和服务器双方发送和接收。头部在初始请求数据从客户端发送到服务器之前发送，类似地，在初始响应数据从服务器发送到客户端之前发送。尾部在服务器关闭 RPC 时发送。

gRPC 元数据有多种用途，例如：

认证：gRPC 元数据可用于向服务器发送认证凭据。这可用于使用标准的 HTTP Authorization 头部实现不同的认证方案，例如 OAuth2 或 JWT。
追踪：gRPC 元数据可用于向服务器发送追踪信息。这可用于追踪请求在分布式系统中的进度。
自定义头部：gRPC 元数据可用于向服务器或从服务器向客户端发送自定义头部。这可用于实现应用程序特有的功能，例如负载均衡、速率限制或从服务器向客户端提供详细的错误信息。
内部使用：gRPC 使用 HTTP/2 头部和尾部，它们将与您的应用程序指定的元数据集成。

测试

在服务端新建一个中间件管道获取请求头，代码如下：

登录可见。

尝试使用 postman 发起请求，如下图：



可以看到使用 postman 设置 Metadata 的值可以在服务端正常接收到。

使用 c# 控制台设置 Metadata 发送请求，代码如下：

登录可见。

如下图：



使用 c# 代码设置 Metadata 的值可以在服务端也正常接收到。如果使用 gRPC 客户端工厂全局添加，代码如下：

登录可见。

参考：

超链接登录可见。
超链接登录可见。