如何在Next.js中为用户保持MongoDB连接直至其离开站点

核心结论 #

给每个访问用户单独创建并保持MongoDB连接不可行，也完全没必要。HTTP是无状态协议，无法精准判断用户“离开站点”的时机，这种做法会导致连接数急剧膨胀，反而加剧连接数超限问题。正确的方案是使用MongoDB官方推荐的连接池机制，在Next.js中全局复用一个MongoClient实例。

问题根源 #

你当前的代码中，每次调用getDb()都会执行MongoClient.connect()，这意味着每个数据库操作都会新建一个独立的MongoDB连接，短时间内大量请求会快速耗尽连接数配额。

实现方案：全局单例MongoClient #

修改models/model.js，将MongoClient实例改为全局单例，利用MongoDB内置的连接池自动管理连接复用：

import { MongoClient } from "mongodb";

// 全局存储已连接的客户端实例
let client;
let clientPromise;

class Model {
  constructor(collectionName) {
    this.collectionName = collectionName;
  }

  async getDb() {
    try {
      // 如果客户端已存在，直接复用
      if (!client) {
        // 仅在首次调用时创建连接，后续复用
        client = new MongoClient(process.env.dbUri);
        clientPromise = client.connect();
      }
      await clientPromise;
      const db = client.db();
      return db.collection(this.collectionName);
    } catch (err) {
      console.log("Model", err);
      throw err;
    }
  }
}

export default Model;

关键说明 #

1. 连接池自动管理：MongoClient默认会维护一个连接池（默认大小为5），当有数据库操作时，会从池中取出空闲连接，操作完成后放回，无需手动管理。
2. 全局单例：整个应用生命周期内只创建一次MongoClient实例，所有数据库操作共享这个实例的连接池，避免重复创建连接。
3. 兼容Next.js环境：Next.js的API路由是无状态的，但全局变量会在服务器进程中保留，只要进程不重启，连接就会持续复用。

其他代码无需修改 #

你的skills.js和API路由代码可以保持不变，因为getDb()现在会复用全局的MongoClient实例，所有数据库操作都会走连接池，不会再每次新建连接。

额外优化建议 #

• 可以通过连接字符串参数调整连接池大小，比如在process.env.dbUri后加上?maxPoolSize=10（根据你的MongoDB配额调整）。
• 避免在API路由中长时间占用连接，确保数据库操作完成后及时释放（MongoDB连接池会自动处理，无需手动关闭）。

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