背景
在开发 Node.js 项目时，我们经常会使用 PM2 进行进程管理和自动重启。但是，有时候我们会遇到 PM2 启动时报错的情况。比如在使用 Koa 框架开发时，我们执行 pm2 start app.js 后，可能会遇到以下报错信息：
Error: Cannot find module 'koa'
这个错误提示非常明显，就是找不到 Koa 模块。但是我们明明已经在项目中安装了 Koa，为什么会找不到呢？
原因
在开发过程中，我们可能会使用 npm 或 yarn 安装一些依赖模块。但是，有时候我们会忘记在生产环境中同样安装这些模块。这就导致了 PM2 在启动时找不到对应的模块，从而出现了上述错误。
具体来说，PM2 启动时会使用 $NODE_PATH 环境变量来寻找模块。如果这个环境变量没有设置或者设置不正确，就会出现找不到模块的错误。
解决方法
针对上述问题，我们可以采取以下几种解决方法：
方法一：手动设置 NODE_PATH
我们可以手动设置 $NODE_PATH 环境变量，让 PM2 能够找到对应的模块。具体来说，我们可以在终端中执行以下命令：
export NODE_PATH=/path/to/node_modules
其中，/path/to/node_modules 是我们项目中 node_modules 目录的绝对路径。
但是，这种方法需要每次启动 PM2 时都手动设置一遍，比较麻烦。因此，我们可以采用更加简便的方法。
方法二：使用 pm2-runtime
PM2 提供了一个 pm2-runtime 命令，它可以自动设置 $NODE_PATH 环境变量，从而避免了手动设置的麻烦。具体来说，我们可以在终端中执行以下命令：
pm2 start app.js --interpreter pm2-nuxt
其中，app.js 是我们要启动的 Node.js 项目入口文件，pm2-nuxt 是一个解释器，它会自动设置 $NODE_PATH 环境变量，并且支持在项目中使用 ES6 模块语法。
方法三：使用 Docker
如果我们使用 Docker 部署 Node.js 项目，就不需要担心找不到模块的问题。因为 Docker 会将项目和依赖一起打包成镜像，从而避免了环境依赖的问题。
具体来说，我们可以编写一个 Dockerfile，将项目和依赖打包成镜像，然后在容器中运行。以下是一个示例 Dockerfile：
-- -------------------- ---- ------- ---- ------- ------- ---- ---- ------------- -- --- --- ------- ---- - - ------ ---- --- ------- --------
在这个 Dockerfile 中，我们使用了 Node.js 14 镜像作为基础镜像，设置了工作目录和端口号，并且将项目和依赖复制到容器中。最后使用 npm start 命令启动项目。
结论
通过以上方法，我们可以轻松解决 PM2 启动时找不到模块的问题。在实际开发中，我们应该注意在生产环境中安装和使用依赖模块，以避免出现类似的问题。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/675fe3e003c3aa6a56fa2ff1