Next.js API路由高效连接MongoDB的最佳实践咨询

首先明确结论：不需要在两个API路由里分别重复调用connect()，复用已有的连接才是更高效的最佳实践。

核心原因 #

MongoDB的Node.js驱动本身会维护一个连接池。第一次调用连接方法时，驱动会创建连接池并建立初始连接；后续所有请求都会直接复用池中的空闲连接，而不是每次新建连接——这是驱动内置的优化机制，无需手动重复创建连接。

具体实现方案 #

把你的connect()改造成单例模式，确保整个应用生命周期内只初始化一次连接：

// lib/mongodb.js
import { MongoClient } from 'mongodb';

let clientPromise;

if (!process.env.MONGODB_URI) {
  throw new Error('请配置MONGODB_URI环境变量');
}

if (process.env.NODE_ENV === 'development') {
  // 开发环境下，通过global对象保存连接，避免热重载重复初始化
  if (!global._mongoClientPromise) {
    const client = new MongoClient(process.env.MONGODB_URI);
    global._mongoClientPromise = client.connect();
  }
  clientPromise = global._mongoClientPromise;
} else {
  // 生产环境直接创建并保存连接
  const client = new MongoClient(process.env.MONGODB_URI);
  clientPromise = client.connect();
}

export default clientPromise;

然后在两个API路由中直接导入这个单例连接即可：

// pages/api/foo.js
import clientPromise from '../../lib/mongodb';

export default async function handler(req, res) {
  const client = await clientPromise;
  const db = client.db('你的数据库名');
  
  // 执行数据操作
  const data = await db.collection('目标集合').find({}).toArray();
  res.status(200).json(data);
}

// pages/api/boo.js
import clientPromise from '../../lib/mongodb';

export default async function handler(req, res) {
  const client = await clientPromise;
  const db = client.db('你的数据库名');
  
  // 执行对应的数据操作
  const data = await db.collection('另一个集合').find({}).toArray();
  res.status(200).json(data);
}

方案优势 #

• 避免重复建立连接，降低数据库服务器负载
• 充分利用MongoDB连接池的复用机制，提升请求处理效率
• 开发环境下通过global对象规避热重载导致的重复连接问题

不管用户刷新页面还是在路由间切换，所有API请求都会复用同一个连接池中的连接，不会重复初始化连接。

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