NestJS应用部署Heroku提示Application Error无报错日志问题求助

1. 端口绑定逻辑排查 #

• 检查NestJS启动监听代码是否显式绑定0.0.0.0，Heroku要求服务必须绑定所有公共网卡，仅绑定localhost/127.0.0.1会导致外部无法访问，正确写法参考：

await app.listen(process.env.PORT || 8080, '0.0.0.0')

• 确认没有代码硬编码固定端口覆盖process.env.PORT，Heroku会动态分配端口，必须读取环境变量赋值的端口。

2. 运行时日志排查 #

部署日志仅记录构建阶段的执行结果，运行时启动抛出的异常不会在部署日志中展示

• 安装Heroku CLI后执行命令拉取实时运行日志，定位启动阶段报错：
  heroku logs --tail --app 替换为你的Heroku应用名称
• 重点排查日志中是否存在依赖缺失、环境变量未找到、数据库连接失败这类启动时抛出的异常。

3. 依赖与启动命令校验 #

• 确认生产启动所需依赖全部放在dependencies中而非devDependencies，Heroku生产环境默认不会安装devDependencies下的包，比如ts-node、typescript这类仅开发需要的包如果生产启动要用，必须移到生产依赖里。
• 检查项目根目录Procfile的web启动命令是否正确，生产环境建议使用构建后的js产物启动，示例配置：
  web: node dist/main.js
• 确认package.json中scripts.build命令正常，Heroku部署时会自动执行npm run build生成构建产物，若build命令执行异常但未触发错误退出，会导致无可用启动文件。

4. 环境变量校验 #

• 对比本地.env文件与Heroku后台Settings > Config Vars中的配置，确认功能改动新增的所有环境变量都已在Heroku端配置，缺失必填环境变量会导致服务启动中断。
• 确认NODE_ENV变量配置符合预期，部分代码逻辑在production环境下会开启严格校验、强制HTTPS等逻辑，配置错误会导致服务启动失败。

5. 资源配额校验 #

• 若使用Heroku免费 tier 实例，内存配额仅为512MB，若NestJS应用启动时内存占用超过配额会被系统OOM机制直接杀掉，表现为无明确报错但服务无法启动，可在运行日志中搜索OutOfMemory、Memory cgroup out of memory关键字确认。

内容的提问来源于stack exchange，提问作者John Patrick Kokar