生产环境MongoDB偶发Cannot read property 'collection' of undefined报错解决

问题根源 #

1. 异步连接逻辑顺序错误：MongoDB连接是异步操作，你当前的代码是先启动Express服务，再异步初始化数据库连接。托管平台的冷启动速度远慢于本地开发环境，大量请求会在数据库连接初始化完成前进入，此时req.app.locals.db或getDb()返回undefined，就会触发报错。本地环境启动速度快，连接几乎瞬间完成，因此很难复现问题。
2. 缺少断连重连处理：MongoDB Atlas的连接会因为网络波动、空闲超时等因素断开，你存储的数据库实例没有更新机制，重连后旧实例失效也会返回undefined。
3. 异步语法混用：接口代码中同时使用await和回调函数处理toArray操作，可能导致异常捕获逻辑失效，问题无法被正确处理。

修复方案 #

1. 调整启动顺序，连接成功后再启动服务 #

将Express服务的启动逻辑放到MongoDB连接成功的回调中，确保所有请求进入时数据库实例已经初始化完成，同时添加重连逻辑：

const MongoClient = mongodb.MongoClient;
const uri = "mongodb+srv://****:****@cluster0.j7sne.mongodb.net/duesweets?retryWrites=true&w=majority";

async function initServer() {
  try {
    // 初始化数据库连接
    const client = await MongoClient.connect(uri, {
      useUnifiedTopology: true,
      connectTimeoutMS: 10000,
      maxPoolSize: 10
    });
    const db = client.db("duesweets");
    app.locals.db = db;
    console.log("数据库连接成功");

    // 连接成功后再监听端口启动服务
    const PORT = process.env.PORT || 3000;
    app.listen(PORT, () => {
      console.log(`服务已启动，端口：${PORT}`);
    });

    // 监听连接断开事件，自动重连
    client.on("connectionClosed", () => {
      console.log("数据库连接断开，尝试重连");
      initServer();
    });
  } catch (err) {
    console.error("服务启动失败：", err);
    process.exit(1);
  }
}

initServer();

2. 优化接口逻辑，修正异步语法 #

去掉await和回调混用的逻辑，同时增加数据库实例存在性判断，异常时返回正确的状态码：

router.get("/sweets/all", async (req, res) => {
  try {
    const db = req.app.locals.db;
    if (!db) {
      return res.status(503).send({ msg: "数据库未就绪，请稍后重试" });
    }
    const result = await db.collection("sweet").find().toArray();
    res.status(200).send(result);
  } catch (err) {
    console.error("接口报错：", err);
    res.status(500).send(err.message);
  }
});

3. 检查Atlas白名单配置 #

确认MongoDB Atlas的IP白名单已经添加了你所使用的托管平台的出口IP，若托管平台使用动态IP，可临时设置白名单为0.0.0.0/0测试，确认问题是否由白名单拦截导致。

4. 增加健康检查接口 #

新增健康检查接口，部署完成后先调用该接口确认数据库连接正常后再对外提供服务：

app.get("/health", (req, res) => {
  res.status(req.app.locals.db ? 200 : 503).send(req.app.locals.db ? "正常" : "数据库未连接");
});

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