向Heroku推送代码时grpc@1.20.0安装脚本报错的原因是什么

核心触发逻辑 #

报错的核心本质是grpc@1.20.0的安装脚本执行失败，这个脚本的运行逻辑是：

1. 优先尝试通过node-pre-gyp从官方存储节点拉取适配当前运行环境的预编译二进制包，跳过本地编译环节
2. 拉取失败时自动回退，通过本地C++编译器把grpc的源码编译为对应Node版本的原生扩展

你遇到的退出码1错误，基本来自以下两种必然会触发的场景：

• 存储旧版预编译包的官方节点已经下线了grpc@1.20.0的对应产物，拉取请求直接返回失败，无法进入后续流程
• 回退到本地编译环节时，grpc@1.20.0是2019年发布的老版本，其依赖的C++编译规则、系统库版本已经和Heroku当前的Node构建镜像完全不兼容，编译过程直接崩溃退出

常见触发背景 #

• 项目锁文件（package-lock.json/yarn.lock）中硬锁了grpc@1.20.0，没有适配Heroku当前默认的Node16/18运行环境（该版本grpc完全不支持新版本V8引擎的编译规则）
• 项目的间接依赖（比如早期版本的Firebase、Google Cloud客户端）强制依赖这个版本的grpc，没有随依赖升级更新
• 构建过程的临时缓存没有清理，导致旧版本的安装脚本和当前环境的匹配逻辑混乱

容易被误导的非相关排查项 #

Heroku日志里提到的“将node_modules提交到源码”的问题，是平台给出的通用排查清单，和你当前的报错无关——哪怕你完全不提交node_modules、清空构建缓存重新安装，这个grpc版本的安装错误依然会复现。日志里提示的“不是npm本身的问题”的表述是准确的：npm只是负责捕获子进程的退出状态，错误根源完全在grpc包自身的安装流程。

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