pm2启动Node.js服务时报gRPC二进制模块版本不匹配问题求解

问题根因 #

该问题的核心是PM2的进程机制不会自动同步nvm的Node版本配置：

1. PM2的后台守护进程一旦启动就会绑定启动时使用的Node版本，后续你修改nvm全局默认版本不会更新已经运行的PM2 daemon的Node版本
2. 如果你是在旧Node版本下全局安装的PM2，PM2执行文件会绑定旧Node的二进制路径，默认调用时始终使用绑定的旧版本Node运行项目

具体解决步骤 #

• 第一步：终止所有PM2进程并杀掉PM2后台守护进程，清除旧版本缓存

pm2 delete all && pm2 kill

• 第二步：确认当前shell会话的Node版本符合项目要求，确保是nvm管理的目标版本

node -v
# 确认输出的版本号和项目要求一致
which node
# 确认输出路径为nvm管理的对应版本路径，如/Users/你的用户名/.nvm/versions/node/vx.x.x/bin/node

• 第三步：在当前正确Node版本下重新全局安装PM2，覆盖旧版本绑定的Node路径

npm install -g pm2

• 第四步：重新安装项目依赖，确保gRPC模块编译适配当前Node版本

rm -rf node_modules package-lock.json npm-shrinkwrap.json
npm install

• 第五步：启动项目时可显式指定Node解释器路径，避免版本匹配异常

pm2 start 你的启动入口文件（如app.js） --interpreter $(which node)

额外说明 #

你之前修改nvm默认版本、删除依赖重装、执行npm rebuild都无效的原因，是上述操作都没有更新PM2实际调用的Node版本。gRPC在安装时会适配当前shell的Node版本，但是PM2调用时用的还是不匹配的旧版Node，就会出现期望ABI版本和实际安装的ABI版本不匹配的报错。

内容的提问来源于stack exchange，提问作者rusli Abdul gani