部署Node.js项目到Heroku出现H10应用崩溃错误该如何解决？

H10错误的本质是应用进程启动后异常崩溃，和路由请求本身无关，可按以下优先级排查：

1. 优先排查数据库连接失败问题 #

• 你本地的.env文件默认会被.gitignore过滤，不会推送到Heroku，所以你配置的MongoDB连接串、JWT密钥等环境变量，Heroku运行环境完全获取不到，数据库连接失败会直接导致进程退出，是这类问题最常见的诱因。
  解决方法：进入Heroku控制台对应项目的设置页，找到Config Vars配置项，把本地.env中所有键值对（比如MONGO_URI、JWT_SECRET等）全部添加到Heroku的环境变量中，不要遗漏。
• 检查./config/db.js中的数据库连接逻辑，是否添加了错误捕获逻辑，连接失败时是否打印错误日志，方便你从heroku logs中定位具体连接问题。

2. 检查依赖兼容性与完整性 #

• bcrypt属于原生依赖，编译时的Node.js版本需要和运行时版本完全一致，否则会启动崩溃。你package.json中指定了Node版本为12.18.0，先确认本地开发用的Node版本和该值一致，可运行node -v核对：如果版本有偏差，要么修改package.json的engines字段为本地Node版本，要么本地切换到12.18.0版本重新安装依赖后再推送代码。
• 确认所有项目中require引入的依赖，都写在package.json的dependencies字段下，不要放在devDependencies中，Heroku部署默认不会安装开发依赖。
• 不要把本地的node_modules文件夹推送到Git，要把node_modules加入.gitignore，让Heroku自动根据依赖清单安装对应平台兼容的依赖包。

3. 端口监听配置核验 #

你现有代码中const PORT = process.env.PORT || 5000的配置是正确的，Heroku会自动分配PORT环境变量，不需要你在.env中硬编码端口，这部分不需要修改，只需确认没有其他位置硬写死监听端口为5000即可。

4. 定位具体报错的调试方法 #

如果以上配置都确认无误还是报错，可以在本地临时重命名.env文件后运行npm start，模拟Heroku无本地.env的运行环境，看本地启动的报错信息；也可以直接运行heroku run node index.js在Heroku容器内直接启动服务，查看控制台输出的具体报错信息，定位问题效率远高于看访问日志。

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