Heroku部署Node.js应用触发node-pre-gyp安装错误如何解决？

报错核心原因是项目依赖的grpc@1.10.1版本过旧，该版本发布时Node.js 14还未推出，没有对应Node 14（ABI版本号v83）的预编译二进制包，且源码也无法在Heroku的新版Linux编译环境下正常编译，和node-pre-gyp版本调整无直接关联。

• 优先升级Firebase依赖到最新稳定版：旧版本Firebase依赖的是已废弃的grpc原生包，新版Firebase已经替换为@grpc/grpc-js纯JS实现的包，完全规避了原生依赖编译问题，不需要额外调整其他依赖版本。
• 若因业务限制无法升级Firebase，可指定Heroku使用Node.js 10版本部署：grpc@1.10.1支持的最高Node.js版本为Node 10，在项目package.json中添加以下配置指定Node版本即可：

{
  "engines": {
    "node": "10.x"
  }
}

• 清理构建缓存验证：部署前执行heroku builds:cache:purge -a 你的应用名清理Heroku的构建缓存，避免旧的依赖缓存干扰新的构建流程。
• 兼容方案：如果需要保留现有Node版本和Firebase版本，可以在package.json中强制指定grpc版本为兼容Node14的1.24.x以上版本，配置后需要测试业务功能兼容性：
  • 若使用Yarn作为包管理器，添加resolutions字段：

  {
    "resolutions": {
      "@firebase/firestore/grpc": "^1.24.0"
    }
  }
  

  • 若使用NPM作为包管理器，除添加上述resolutions字段外，还需要在scripts中添加预安装脚本使版本锁定生效：

  {
    "scripts": {
      "preinstall": "npx npm-force-resolutions"
    }
  }
  

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