NodeJS服务器本地正常，PM2运行时因依赖文件加载崩溃求助

看起来你遇到了本地测试一切正常，但用PM2启动服务器就触发模块编译错误的问题，这种情况大多和PM2的工作目录、路径解析或者运行上下文有关。我整理了几个常见的排查方向和解决办法，你可以逐一尝试：

1. 确认PM2的工作目录是否正确 #

PM2启动时的工作目录可能和你本地测试时的项目根目录不一致，导致../models/user.js的相对路径解析失败。

• 先查看当前PM2服务的工作目录：

  pm2 show dataServ | grep cwd
  

• 如果显示的路径不是你的项目根目录，启动PM2时指定正确的工作目录：

  pm2 start 你的服务器入口文件.js --cwd /你的项目根目录绝对路径
  

  或者创建PM2配置文件ecosystem.config.js，在里面明确指定工作目录：

  module.exports = {
    apps: [{
      name: 'dataServ',
      script: 'server.js', // 你的服务器入口文件
      cwd: '/home/xxx/your-project-root' // 替换成你的项目根目录绝对路径
    }]
  };
  

  之后用pm2 start ecosystem.config.js启动服务。

2. 检查文件路径和大小写一致性 #

如果你的服务器运行在Linux环境下，系统是大小写敏感的，而本地开发可能在Windows/macOS（默认不区分大小写）环境，这时候文件名大小写不匹配就会导致模块找不到。

• 确认models/user.js的实际文件名和你require语句里的路径完全一致，比如不要出现本地是User.js但代码里写user.js的情况。

3. 改用绝对路径引入模块 #

相对路径有时候会因为Node.js的模块加载机制出现解析偏差，换成绝对路径可以彻底避免这个问题：

• 在passport.js里用__dirname拼接绝对路径：

  const path = require('path');
  const User = require(path.join(__dirname, '../models/user'));
  

  或者更直接的写法：

  const User = require(path.resolve(__dirname, '../models/user'));
  

4. 清理PM2缓存后重启 #

有时候PM2会缓存旧的模块文件，导致你修改后的代码没有生效，进而触发错误：

• 先删除现有服务并清理缓存：

  pm2 delete dataServ
  pm2 cache clean
  

• 然后重新启动服务：

  pm2 start 你的服务器入口文件.js
  

5. 检查Node.js版本是否一致 #

本地测试的Node.js版本和PM2运行环境的Node版本如果不一致，某些语法或模块加载行为可能会有差异，导致报错：

• 查看本地Node版本：

  node -v
  

• 查看PM2使用的Node版本：

  pm2 env dataServ | grep NODE_VERSION
  

• 如果版本不一致，可以指定PM2使用的Node解释器路径：

  pm2 start 你的服务器入口文件.js --interpreter /usr/local/bin/node # 替换成你的Node绝对路径
  

你可以先从检查工作目录和路径大小写开始，这两个是最常见的触发原因。如果还是解决不了，可以把完整的错误栈信息贴出来，方便进一步排查。

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