TypeScript项目经GitHub Actions部署到Heroku后立即崩溃如何解决？

核心问题定位 #

从你提供的运行日志可以看出，应用启动时已经成功监听端口，随后立即异常退出，这个现象符合启动后异步逻辑（通常是数据库连接）执行失败抛出未捕获异常的特征。

常见原因及解决方案 #

• 1. MongoDB连接失败（最高概率） #

  你测试环境使用的是MONGODB_URL_TEST，生产环境使用的是MONGODB_URL，大概率是以下两个问题导致连接失败：
  • IP白名单限制：如果你使用的是MongoDB Atlas这类云数据库服务，默认只允许白名单内的IP访问，你需要在MongoDB控制台将0.0.0.0/0加入白名单，开放所有IP访问权限（Heroku的出口IP不固定，无法单独绑定）。
  • 环境变量读取错误：确认你的代码中读取数据库连接地址的变量名是否为MONGODB_URL，没有拼写错误，也没有误写为测试环境的MONGODB_URL_TEST。

• 2. 未捕获异常导致进程退出 #

  你的日志中没有输出具体错误信息，是因为代码中没有捕获全局异常，建议在项目入口文件顶部添加全局异常捕获逻辑，便于排查具体错误：

  process.on('uncaughtException', (err) => {
    console.error('未捕获的异常：', err);
    process.exit(1);
  });
  
  process.on('unhandledRejection', (reason, promise) => {
    console.error('未处理的Promise拒绝：', reason, promise);
    process.exit(1);
  });
  

  添加后重新部署，就能在Heroku日志中看到具体的报错原因。

• 3. 配置冗余问题（不影响运行，可优化） #

  你在GitHub Action中已经执行了yarn build，但Heroku部署时又会自动执行一次build命令，属于冗余操作。如果要优化可以调整Heroku buildpack配置跳过build步骤。

内容的提问来源于stack exchange，提问作者João Casarin