Heroku部署Node.js+Express应用无功能，本地运行正常该如何排查？

从你提供的构建日志和现象来看，最常见的诱因有四类：

• 端口配置错误：Express服务如果硬编码了本地端口（如3000、8080），Heroku运行时会自动分配PORT环境变量，服务未监听该端口就会无法响应请求
• 启动命令配置错误：日志明确显示Procfile declares types -> (none)，说明你未自定义Procfile，使用了buildpack默认的web启动规则，默认会读取package.json中的start脚本，如果该脚本配置错误（如入口文件名错误、参数错误），进程将无法正常启动
• 依赖缺失：Heroku构建时会自动裁剪devDependencies中的包，如果你把生产运行必需的依赖放到了开发依赖分类下，线上运行时会因找不到依赖报错
• Node.js版本不兼容：日志显示你未在package.json中指定node和npm版本，Heroku默认使用了14.x版本，如果你的本地开发用的是更高版本的Node.js，部分新语法特性在14.x环境下不兼容会导致运行失败

• 修正端口监听配置
  将Express服务的监听逻辑改为优先读取环境变量中的端口，参考代码：

const PORT = process.env.PORT || 3000
app.listen(PORT, () => {
  console.log(`服务运行在端口${PORT}`)
})

• 校准启动命令
  首先确认package.json的scripts字段有正确的start配置，例如入口文件为server.js时配置如下：

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

如果启动逻辑比较复杂，也可以在项目根目录新建无后缀的Procfile文件，写入启动命令：
web: node server.js

• 调整依赖分类
  确认所有生产运行需要的包都放在dependencies字段下，仅将开发工具（如eslint、nodemon）放到devDependencies中
• 锁定Node.js版本
  在package.json中添加engines字段，和本地开发使用的Node.js、npm版本保持一致，示例配置：

{
  "engines": {
    "node": "16.x",
    "npm": "8.x"
  }
}

• 查看线上日志定位问题
  如果修改后仍未恢复，运行heroku logs --tail命令查看实时运行日志，根据具体报错信息进一步定位问题

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