grpc-node错误消息异常添加2 UNKNOWN:前缀导致测试失败求助

嘿，我之前也踩过gRPC-node这个坑，测试突然全挂，错误消息平白多了个前缀，太闹心了。结合我的经验，给你分析下原因和解决办法：

为啥会出现这个问题？ #

• 版本更新搞的鬼：如果最近升级了@grpc/grpc-js或者相关依赖，新版本大概率调整了错误消息的格式化逻辑，默认把gRPC的状态码和类型前缀拼到了消息文本里。
• 错误处理逻辑被改了：不管是服务端还是客户端的错误中间件、拦截器，要是有人动过这块代码，可能不小心把错误消息重新包装了一遍，带上了这个前缀。
• 服务端错误返回不规范：服务端返回错误时没正确用gRPC的错误对象，而是扔了个普通Error，客户端解析的时候就自动补上了默认的2 UNKNOWN状态码前缀。

怎么解决？ #

1. 先试试回退版本 #

如果是升级后才出的问题，最快的办法就是回退到之前能用的版本。打开package.json，把@grpc/grpc-js的版本锁死，比如：

"@grpc/grpc-js": "1.8.17"

然后跑npm install重装依赖，再跑测试看看是不是好了。

2. 客户端手动剥离前缀 #

要是不能回退版本，就在客户端写个小工具函数，把前缀去掉再做断言：

function getCleanGrpcErrorMsg(error) {
  // 针对UNKNOWN状态的前缀，其他状态码可以按需扩展
  const prefix = '2 UNKNOWN: ';
  return error.message.startsWith(prefix) ? error.message.slice(prefix.length) : error.message;
}

测试的时候用这个函数处理实际错误消息：

const cleanMsg = getCleanGrpcErrorMsg(error);
expect(cleanMsg).toBe("Zone doesn't exist");

3. 修正服务端的错误返回 #

让服务端返回标准的gRPC错误对象，别用普通Error。比如用@grpc/grpc-js的状态码常量：

const { status } = require('@grpc/grpc-js');

// 在你的服务方法里，这样返回错误
call.emit('error', {
  code: status.NOT_FOUND, // 用对应的状态码，比如NOT_FOUND是5
  message: "Zone doesn't exist"
});

这样客户端收到的错误前缀会变成对应状态码的标识（比如"5 NOT_FOUND: "），要么调整测试预期，要么继续用上面的剥离函数处理就行。

4. 检查拦截器/中间件 #

如果项目里用了gRPC的拦截器（比如日志、权限校验的拦截器），去看看是不是拦截器在处理错误时加了这个前缀。比如有些日志拦截器会格式化错误消息，得调整下拦截器逻辑，别改动原始的错误文本。

总结 #

大概率是版本更新带来的行为变化，先查版本变更，再根据项目情况选回退版本、客户端处理或者服务端修正的方案，应该很快就能搞定。

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