Node.js API应用在Heroku部署成功后日志报错如何处理？

通用排查步骤 #

• 端口合规性检查
  Heroku 不允许应用监听固定端口，必须读取平台分配的动态端口环境变量，监听代码写法需符合规范：

// 正确写法，优先读取Heroku分配的PORT，本地开发 fallback 到自定义端口
app.listen(process.env.PORT || 3000, () => {
  console.log('服务启动成功')
})

如果代码中硬编码了固定端口，会直接导致启动失败抛出报错。

• 依赖完整性检查
  确认所有生产环境需要的依赖都写入package.json的dependencies字段，不要将生产依赖误放到devDependencies中，Heroku 部署默认不会安装开发依赖。可本地执行npm install --production后启动项目，验证是否存在依赖缺失问题。
• 启动脚本检查
  确认package.json中scripts.start配置为生产启动命令，不要使用nodemon等开发工具启动，示例配置：

{
  "scripts": {
    "start": "node server.js"
  }
}

需将server.js替换为你项目的实际入口文件名。

• 环境变量检查
  登录Heroku控制台进入对应应用的设置页，找到配置变量板块，比对项目所需的所有环境变量（如数据库连接字符串、第三方服务密钥等）是否完整配置，不存在遗漏或取值错误。
• 本地模拟复现排查
  本地安装Heroku CLI后，在项目根目录执行heroku local web，即可直接模拟Heroku的运行环境启动项目，输出和线上一致的日志信息，方便快速定位问题。

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