部署MERN Stack应用至Heroku时遭遇MODULE_NOT_FOUND错误的解决求助

云上老周

2026-4-30

解决Heroku部署中的MODULE_NOT_FOUND错误

我来帮你分析并解决这个部署问题，结合你的项目配置来看，这个错误主要来自几个容易忽略的配置问题，下面是具体的成因和修复步骤：

可能的错误成因

入口文件路径错误：你的server.js实际放在backend目录下，但你的Procfile和package.json里的start脚本都是直接执行node server.js——Heroku会在项目根目录运行这个命令，自然找不到server.js文件，直接触发MODULE_NOT_FOUND。
前端构建脚本错误：你的build脚本用了npm run dev（这是开发模式的启动命令），而不是生产环境的构建命令npm run build，导致Heroku上没有生成正确的前端静态资源，可能间接引发路径相关的模块查找问题。
相对路径的不确定性：虽然本地环境中../frontend/build的路径能正常工作，但在Heroku的容器环境中，相对路径偶尔会因为工作目录的细微差异出现解析问题。

分步修复方案

1. 修正启动命令（最关键）

首先要让Heroku找到正确的后端入口文件：

更新你的Procfile，改为指向正确的文件路径：
```
web node backend/server.js
```
同步更新package.json里的start脚本：
```
"scripts": {
  // 保留其他脚本，只修改start
  "start": "node backend/server.js",
  // ...
}
```
这样Heroku启动时会在项目根目录正确定位到backend/server.js，避免找不到入口文件的错误。

2. 修复前端构建脚本

生产环境下需要生成前端静态文件，所以要把build脚本改成正确的生产构建命令：

"scripts": {
  "build": "cd frontend && npm run build",
  "install-client": "cd frontend && npm install",
  "heroku-postbuild": "npm run install-client && npm run build",
  // 其他脚本保持不变
}

注意：要确保你的前端项目（frontend目录）的package.json里存在build脚本（比如Create React App等框架默认自带这个脚本），这样Heroku才能生成正确的静态资源包。

3. 优化路径解析（可选但推荐）

为了避免相对路径在不同环境下的问题，建议把server.js里的静态文件路径改成更可靠的绝对路径写法：

// 替换原来的生产环境配置部分
if(process.env.NODE_ENV === "production") {
  // 从当前server.js所在的backend目录，向上一级找到frontend/build
  const frontendBuildPath = path.join(__dirname, '..', 'frontend', 'build');
  app.use(express.static(frontendBuildPath));
  app.get('*',(req,res) => {
    res.sendFile(path.join(frontendBuildPath, 'index.html'));
  })
}

用path.join拼接路径可以自动适配不同操作系统的路径分隔符，比直接写../更稳定。

4. 验证依赖配置

最后确认几个细节，确保Heroku能正确安装依赖：

不要把node_modules提交到Git仓库（检查你的.gitignore是否包含node_modules/），Heroku会自动执行npm install来安装根目录和前端目录的所有依赖。
核对根目录package.json的dependencies，确保所有后端需要的包（比如express、mongoose等）都已正确声明。

重新部署测试

修改完成后，提交代码并重新部署到Heroku：

git add .
git commit -m "Fix deployment MODULE_NOT_FOUND error"
git push heroku main

部署完成后，用heroku logs --tail实时查看日志，确认错误是否已经解决。

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