Node gRPC：无错误场景下服务端向客户端传递元数据问题

首先明确两个核心点：

• gRPC规范完全允许服务端在无错误、返回正常响应的情况下发送元数据，并没有禁止这种场景
• 你试的callback(null, r, meta)无效，是因为Node.js的gRPC库（不管是旧的grpc包还是新的@grpc/grpc-js）里，回调函数的第三个参数仅在第一个参数为错误（非null）时才会被解析为元数据，成功场景下这个参数会被直接忽略

下面具体说Node环境下服务端发送初始元数据和尾部元数据的正确方法：

1. 发送初始元数据（Headers） #

初始元数据是在响应体发送前就传递给客户端的元数据，服务端可以通过call.sendMetadata()方法主动发送，和后续响应是否成功无关。

服务端示例：

function myRpcHandler(call, callback) {
  // 构建初始元数据
  const initialMeta = new grpc.Metadata();
  initialMeta.add('x-server-header', 'hello-client');
  
  // 发送初始元数据
  call.sendMetadata(initialMeta);

  // 处理业务逻辑，返回正常响应
  const response = { result: 'success' };
  callback(null, response);
}

客户端接收初始元数据：
需要通过RPC调用返回的call对象监听metadata事件：

const clientMeta = new grpc.Metadata();
clientMeta.add('xyz', 'okay');

const call = stub.myRpcMethod(request, clientMeta, (err, response) => {
  if (err) {
    console.error('RPC failed:', err);
    return;
  }
  console.log('Received response:', response);
});

// 监听初始元数据
call.on('metadata', (metadata) => {
  console.log('Initial metadata:', metadata.get('x-server-header'));
});

2. 发送尾部元数据（Trailers） #

尾部元数据是和响应状态一起发送的元数据，成功场景下不能通过回调传递，必须使用call.sendTrailers()方法。

服务端示例：

function myRpcHandler(call, callback) {
  // 处理业务逻辑
  const response = { result: 'success' };
  
  // 构建尾部元数据
  const trailerMeta = new grpc.Metadata();
  trailerMeta.add('x-server-trailer', 'goodbye-client');
  
  // 先返回响应，再发送尾部元数据（顺序不影响，只要在RPC结束前调用即可）
  callback(null, response);
  call.sendTrailers(trailerMeta);
}

客户端接收尾部元数据：
需要监听call对象的status事件，尾部元数据会包含在status对象的metadata属性中：

const call = stub.myRpcMethod(request, clientMeta, (err, response) => {
  if (err) {
    console.error('RPC failed:', err);
    return;
  }
  console.log('Received response:', response);
});

// 监听尾部元数据
call.on('status', (status) => {
  console.log('Trailer metadata:', status.metadata.get('x-server-trailer'));
});

补充：gRPC规范的相关说明 #

根据gRPC官方规范，RPC的生命周期中存在三个可传递元数据的阶段：

1. 客户端发送请求元数据 → 服务端接收
2. 服务端发送初始元数据 → 客户端接收（在响应体之前）
3. 服务端发送尾部元数据 → 客户端接收（在响应体之后，无论RPC成功或失败）

所以成功RPC携带尾部元数据是完全合规的，只是Node的gRPC库没有把这个能力封装到成功回调的参数里，需要用专门的API来实现。

内容的提问来源于stack exchange，提问作者treecoder