Heroku部署Node.js报错Process exited with status 126如何解决

核心故障点 #

从日志和代码排查，故障由以下几个明确问题导致：

• 代码缺失Mongoose依赖引入：index.js中直接调用mongoose.connect()方法，但顶部依赖声明区域没有写入const mongoose = require("mongoose")，Node.js启动时会直接抛出引用错误导致进程退出。
• 启动路径/环境不匹配：日志返回No such file or directory错误、进程退出码126代表执行命令时找不到目标文件或无执行权限，触发原因要么是index.js不在项目根目录、和Procfile路径不匹配，要么是把本地编译的node_modules文件夹提交到了仓库，和Heroku的Linux运行环境不兼容。

修复步骤 #

• 补全依赖导入
  打开根目录下的index.js，在现有依赖引入行的位置添加Mongoose导入语句：

require("dotenv").config()
const express = require("express")
const mongoose = require("mongoose") // 新增这行
const app = express()
const http = require("http")

• 检查依赖声明
  打开根目录的package.json，确认dependencies节点包含所有用到的依赖包：

{
  "dependencies": {
    "express": "^x.x.x",
    "mongoose": "^x.x.x",
    "dotenv": "^x.x.x"
  }
}

如果缺失对应依赖，本地执行npm install 包名 --save更新依赖清单后再提交。

• 校验入口文件路径
  确认index.js和Procfile、package.json都在项目根目录，如果index.js放在src等子文件夹下，修改Procfile的启动命令为对应路径，例如：

web: node src/index.js

• 修正Git提交规则
  检查项目根目录的.gitignore文件，确保包含node_modules条目，不要把本地安装的依赖文件夹提交到仓库，否则Heroku不会重新在线安装适配环境的依赖，会直接导致执行错误。

修复完成后重新推送代码到Heroku触发部署，部署完成后可通过heroku logs --tail命令查看实时日志，确认服务正常监听端口、数据库连接成功后，再访问根路由即可正常返回内容。你已正确配置的MONGO_URL环境变量、现有PORT监听写法均符合Heroku部署要求，无需额外调整。

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