本地MongoDB为何会建立大量连接？

问题根源 #

你当前的代码缓存了Db实例，但没有缓存MongoClient对象。Db是依赖MongoClient存在的派生对象，当MongoClient被重新创建或垃圾回收时，新的数据库连接会被建立。本地环境下MongoDB连接速度极快，再加上开发环境可能存在的热重载、模块重复加载等场景，会导致cachedDb缓存失效，每次调用connectToDatabase都会创建新的MongoClient，进而产生大量新连接。而远程环境因为网络延迟较高，连接池的复用机制能更好地生效，因此未出现该问题。

修复方案 #

1. 缓存MongoClient而非Db #

修改连接代码，直接缓存MongoClient实例，确保整个应用生命周期内只创建一个Client，复用其连接池：

import { MongoClient, Db } from 'mongodb';

let cachedClient: MongoClient | null = null;
let cachedDb: Db | null = null;

export async function connectToDatabase(): Promise<{ db: Db }> {
  if (cachedClient && cachedDb) {
    return { db: cachedDb };
  }

  const client = await MongoClient.connect(MONGODB_URI, {
    // 配置连接池参数，限制最大连接数
    maxPoolSize: 10, // 根据业务需求调整，本地开发建议设小
    minPoolSize: 1,
    connectTimeoutMS: 30000,
  });

  const db = client.db(MONGODB_DB);
  
  cachedClient = client;
  cachedDb = db;

  // 进程退出时关闭Client，释放连接
  process.on('SIGINT', async () => {
    await cachedClient?.close();
    process.exit(0);
  });

  return { db };
}

2. 验证连接池复用 #

调用方式保持不变，现在每次获取的db都来自同一个MongoClient的连接池，不会持续创建新连接。你可以通过MongoDB日志观察connectionCount是否不再持续增长。

3. 排查开发环境热重载问题 #

如果使用Next.js、NestJS等带热重载的框架，需要确保缓存的MongoClient不会在热重载时被重置。可以借助框架的生命周期钩子（比如Next.js的全局缓存、NestJS的模块单例机制）保证Client的单例性。

补充说明 #

• maxPoolSize：设置连接池的最大连接数，默认值为100，本地开发可适当调小避免连接过多占用资源。
• 本地MongoDB默认连接限制较高，但大量闲置连接仍会消耗系统资源，通过连接池配置可有效控制连接数量。

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