Proto3与Node.js交互时version字段数据类型不匹配报错如何解决

日志中打印的version_$numberLong="1"说明客户端传入的version字段并非普通数值或字符串，而是BSON扩展JSON格式的嵌套结构{ "$numberLong": "1" }。Proto3的数值类型校验无法识别该结构，因此抛出类型不匹配错误。你之前尝试修改字段类型为int32、float都无法解决，是因为入参本身不是可直接转换的基础类型。

• 客户端侧适配（优先方案）
  客户端序列化数据时调整BSON转JSON的配置，将NumberLong类型直接转为普通数值。以Node.js MongoDB驱动为例，设置序列化参数promoteLongs: true，数值范围在JS安全整数范围内的Long类型会自动转为Number类型，从根源避免生成$numberLong嵌套结构。

• 服务端前置转换（兼容性最优方案）
  不修改客户端逻辑的前提下，在Proto序列化前添加字段预处理逻辑，统一转换$numberLong结构为数值，示例代码如下：

// 递归处理入参中的$numberLong类型字段
function normalizeBsonFields(data) {
  if (typeof data === 'object' && data !== null) {
    // 匹配NumberLong的扩展JSON结构
    if ('$numberLong' in data) {
      return parseInt(data.$numberLong, 10);
    }
    // 递归处理嵌套对象/数组
    for (const key in data) {
      data[key] = normalizeBsonFields(data[key]);
    }
  }
  return data;
}

// 预处理后再执行Proto序列化
const normalizedReq = normalizeBsonFields(rawClientRequest);
const protoReq = Request.fromObject(normalizedReq);

• Proto兼容兜底（临时解决方案）
  如果上下游暂时无法对齐改造，可临时将version的Proto类型改为optional string version = 8，在业务代码中自行将字符串转为整数使用，待链路对齐后再切回数值类型。

• 确认使用的Proto3解析库（如protobufjs、@grpc/proto-loader）已升级到支持optional字段的版本，避免可选字段解析异常。
• 如果version数值可能超过int32范围，建议将Proto类型改为int64，JS侧可按需用BigInt接收避免精度丢失。

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