Heroku部署Node.js项目成功但访问分配URL异常求助

你这个场景是Node服务部署Heroku的典型报错，结合贴出的package.json，几个明确的问题点和修复方法如下：

• 端口绑定硬编码：Heroku不会使用本地开发写死的端口（比如3000、5000），平台会通过PORT环境变量动态分配服务监听端口，如果在server.js里写死监听固定端口，平台网关无法转发请求，直接返回应用错误。
  把监听代码改成下面的写法即可：

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

  如果用了Socket.io，也要同步把监听绑定到这个动态端口上，不要单独写死端口。
• package.json格式错误：贴出的配置在代码块外多了一个孤立的}，JSON语法不合法会导致Heroku无法正确解析依赖、执行启动脚本，看起来部署流程跑完了，实际上服务根本没启动成功。修正后的合法配置参考：

  {
    "name": "server",
    "version": "1.0.0",
    "engines": { "node": "18.x" },
    "description": "production ready server",
    "main": "server.js",
    "scripts": {
      "start": "node server.js",
      "server:dev": "set NODE_ENV=development&&nodemon server.js",
      "server:prod": "set NODE_ENV=production&&node server.js"
    },
    "author": "Me",
    "license": "ISC",
    "dependencies": {
      "cors": "^2.8.5",
      "express": "^4.17.2",
      "express-session": "^1.16.2",
      "express-socket.io-session": "^1.3.5",
      "mongo": "^0.1.0",
      "mongodb": "^3.7.3",
      "socket.io": "^4.2.0"
    },
    "devDependencies": {
      "nodemon": "1.18.10"
    }
  }
  

  注意配置里把原指定的Node 14.x改成了18.x，Heroku早就停止了Node 14版本的运行时支持，用旧版本会有不可预期的兼容问题。
• 数据库连接配置错误：Heroku默认不提供内置MongoDB服务，如果代码里写死了本地Mongo连接地址（比如mongodb://localhost:27017/xxx），生产环境根本无法连通数据库，服务启动过程中会直接崩溃。需要申请MongoDB Atlas这类云数据库服务，把连接串配置到Heroku的环境变量中，不要硬编码在代码里。
• 脚本跨平台兼容问题：写的server:dev、server:prod脚本里用了Windows cmd专属的set命令配置环境变量，Heroku运行环境是Linux，执行这两个命令会直接报错。目前start脚本没有用到这个逻辑暂时不影响启动，后续如果要配置生产环境变量，直接在Heroku后台Config Vars里添加即可，不用在脚本里写。

精准定位错误的方法 #

不用靠猜报错原因，本地安装Heroku CLI后，在项目目录执行下面的命令就能拉取服务的实时运行日志，所有启动、运行时的报错都会完整打印：

heroku logs --tail

常见日志报错对应解决方向：

• 报Error R10 (Boot timeout)：服务启动超时，大概率是数据库连接失败卡住，或者端口没正确绑定
• 报Missing script: "start"：package.json语法错误，或者start脚本配置缺失
• 报Module not found：依赖缺失，检查是不是把运行需要的包装到了devDependencies里，Heroku生产环境默认不会安装devDependencies下的包

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