求助：GitHub分支部署Heroku后出现Application error问题

问题背景 #

将GitHub仓库的main分支手动部署至Heroku后，部署流程提示成功，但访问应用页面时显示「Application error」。已执行heroku logs --tail命令获取日志信息，对应错误页、日志内容见相关截图。

核心排查与修复步骤 #

1. 校验端口监听逻辑 #

Heroku采用动态端口分配机制，应用必须监听PORT环境变量指定的端口，禁止硬编码固定端口：

• Node.js示例代码：

  const port = process.env.PORT || 3000;
  app.listen(port, () => {
    console.log(`Server running on port ${port}`);
  });
  

• 其他语言框架需遵循相同逻辑，确保读取PORT环境变量作为监听端口。

2. 检查Procfile配置 #

Heroku依赖根目录下的Procfile（无文件后缀）确定启动命令，需确保配置正确：

• Node.js应用示例Procfile内容：

  web: node server.js
  

• Python Flask应用示例Procfile内容：

  web: gunicorn app:app
  

若未配置Procfile，Heroku会尝试调用项目依赖文件中的start命令（如package.json的scripts.start），需确保该命令正确。

3. 确认依赖完整性 #

• 检查项目根目录的依赖文件（如package.json、requirements.txt），确保所有生产环境必需的依赖已声明。
• 若日志中出现module not found类报错，需确认对应依赖已添加至依赖文件，且部署过程中完成安装。

4. 解析日志关键错误 #

重点关注日志中的典型错误标识：

• Error R10 (Boot timeout)：应用启动超时，大概率是端口未正确监听或启动命令无效。
• Error H10 (App crashed)：应用崩溃，需定位日志中的报错栈信息（如未捕获异常、配置缺失）。

5. 本地模拟Heroku环境测试 #

• 设置本地环境变量PORT，执行启动命令，验证应用能否正常启动并访问。
• 使用heroku local命令（需安装Heroku CLI）在本地模拟Heroku运行环境，复现并排查启动问题。

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