Ubuntu环境下用PM2启动Node服务时数据库请求超时问题

核心问题分析 #

报错MongooseError: Operation quotes.find() buffering timed out本质是Mongoose尚未建立数据库连接就执行了查询操作。而npm启动正常、PM2启动异常的核心差异，大概率是环境变量加载逻辑不同或进程启动上下文不一致导致的。

具体解决方案 #

1. 确保PM2加载MongoDB环境变量 #

npm启动时会继承当前Shell的环境变量，但PM2作为后台守护进程，默认不会自动加载用户Shell（如~/.bashrc、~/.profile）中的环境变量，这会导致process.env.MONGO_ATLAS_USER和process.env.MONGO_ATLAS_PW为空，进而数据库连接失败。

可选解决方式：

• 方式一：启动时显式传入环境变量

  MONGO_ATLAS_USER=你的用户名 MONGO_ATLAS_PW=你的密码 pm2 start server.js
  

• 方式二：使用PM2配置文件管理环境变量
  在项目根目录创建ecosystem.config.js：

  module.exports = {
    apps : [{
      name: "api-server",
      script: "./server.js",
      env: {
        MONGO_ATLAS_USER: "你的用户名",
        MONGO_ATLAS_PW: "你的密码",
        NODE_ENV: "production"
      }
    }]
  }
  

  启动命令改为：

  pm2 start ecosystem.config.js
  

• 方式三：让PM2加载Shell环境变量
  如果环境变量存储在~/.bashrc中，可通过以下命令启动：

  source ~/.bashrc && pm2 start server.js
  

  或者配合dotenv包，在ecosystem.config.js中添加：

  interpreter_args: "-r dotenv/config"
  

  同时确保项目根目录有.env文件存储环境变量。

2. 优化Mongoose连接逻辑 #

当前代码未等待数据库连接成功就启动HTTP服务，容易导致查询时连接未就绪。修改代码确保连接成功后再启动服务：

修改app.js，封装数据库连接Promise：

const express = require('express');
const app = express();
const morgan = require('morgan');
const bodyParser = require('body-parser');
const mongoose = require('mongoose');

const contactRoutes = require('./api/routes/contacts');
const userRoutes = require('./api/routes/users');
const configuratorRoutes = require('./api/routes/configurators');
const quoteRoutes = require('./api/routes/quotes');

// 封装数据库连接逻辑
const dbConnect = async () => {
  try {
    await mongoose.connect(`mongodb+srv://${process.env.MONGO_ATLAS_USER}:${process.env.MONGO_ATLAS_PW}@******.mongodb.net/?retryWrites=true&w=majority`);
    console.log('MongoDB 连接成功');
  } catch (err) {
    console.error('MongoDB 连接失败:', err);
    process.exit(1); // 连接失败直接退出进程
  }
};

// 原有中间件、CORS、路由、错误处理逻辑保持不变

module.exports = { app, dbConnect };

修改server.js，等待连接成功后启动服务：

const http = require('http');
const { app, dbConnect } = require('./app');
const port = process.env.PORT || 3000;

// 先完成数据库连接，再启动HTTP服务
dbConnect().then(() => {
  const server = http.createServer(app);
  server.listen(port, () => {
    console.log(`服务运行在端口 ${port}`);
  });
});

3. 验证PM2进程的环境变量 #

用以下命令查看PM2进程的环境变量，确认MongoDB相关变量是否存在：

pm2 env api-server # 替换为你的PM2进程名称

如果未找到目标变量，回到第一步重新配置环境变量加载方式。

4. 关于pm2 start app.js出现502的说明 #

app.js仅导出Express实例，未调用listen启动HTTP服务，直接启动会导致反向代理（如Nginx）无法连接到服务，因此必须启动server.js作为入口文件。

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