grpc-node 客户端升级后遇到大消息长度解析错误问题分析

问题背景

在将 grpc-node 客户端升级到 1.10.9 版本后，部分用户开始随机遇到 RESOURCE_EXHAUSTED: Received message larger than max (808722544 vs 4194304) 错误。这个错误表明客户端收到了一个超过最大允许大小的消息（808,722,544 字节），而客户端的最大限制设置为 4,194,304 字节（4MB）。

问题根源

深入分析后发现，这个问题实际上与中间件 Traefik 返回的 404 响应有关。当 Traefik 返回非 gRPC 格式的响应时，grpc-node 客户端仍然尝试按照 gRPC 协议解析响应数据。

在 gRPC 协议中，消息的前 4 个字节表示消息长度。当 Traefik 返回 HTTP 404 响应时，响应体开头是 "404 "（ASCII 码为 52,48,52,32），grpc-node 客户端错误地将这些字节解析为消息长度：

function readUInt32BE(offset = 0) {
  validateNumber(offset, 'offset');
  const first = this[offset];
  const last = this[offset + 3];
  if (first === undefined || last === undefined)
    boundsError(offset, this.length - 4);

  return first * 2 ** 24 +
    this[++offset] * 2 ** 16 +
    this[++offset] * 2 ** 8 +
    last;
}

计算结果是 52*(2^24) + 48*(2^16) + 52*(2^8) + 32 = 808,722,544，这解释了为什么客户端报告收到了一个 800MB 大小的"消息"。

版本变化影响

这个问题在 grpc-node 1.10.9 版本中变得明显，是因为该版本引入了一个提交，增加了对接收消息大小的严格检查。在之前的版本中，虽然也存在解析错误，但由于没有严格的大小验证，错误表现可能不同或更隐蔽。

解决方案

1. 确保中间件正确处理 gRPC 请求：配置 Traefik 或其他中间件正确处理 gRPC 请求，避免返回非 gRPC 格式的响应。

2. 客户端容错处理：在客户端增加对异常响应的处理逻辑，当检测到非 gRPC 格式响应时，给出更友好的错误提示。

3. 协议兼容性检查：在解析消息前，可以增加对响应格式的检查，确认是否为合法的 gRPC 响应。

技术启示

这个问题揭示了几个重要的技术点：

1. 协议严格性：在实现网络协议时，必须严格遵循协议规范，同时对非规范输入要有良好的容错处理。

2. 中间件兼容性：在使用中间件代理 gRPC 请求时，必须确保中间件完全支持 gRPC 协议特性。

3. 版本升级影响：看似无害的严格性检查改进可能会暴露出之前隐藏的问题，升级时需要全面测试。

4. 错误处理重要性：良好的错误处理机制可以帮助快速定位问题根源，而不是让开发者面对令人困惑的表面现象。

这个问题也提醒我们，在网络编程中，协议解析的鲁棒性至关重要，特别是在处理可能被中间件修改的流量时。