Next.js中MongoDB仅建立一次连接的技术疑问

你担心的问题确实存在——如果直接在每个API路由里写MongoDB连接代码，默认情况下每次API调用都会尝试新建连接，这不仅低效，还可能导致数据库连接数超标。但完全不需要像Express那样专门搞一个app.js来存连接，Next.js里有更优雅的解决方案：

核心思路：用单例模式+模块缓存复用连接 #

Node.js模块加载后会自动缓存，我们可以把MongoDB连接逻辑封装成一个单例模块，这样不管多少个API路由调用，都会复用同一个连接实例（以及MongoDB自带的连接池）。

步骤1：创建连接封装模块 #

在项目根目录新建lib/mongodb.js，写如下代码：

import { MongoClient } from 'mongodb';

const uri = process.env.MONGODB_URI;
const options = {
  useUnifiedTopology: true,
  useNewUrlParser: true,
};

let client;
let clientPromise;

// 先检查环境变量是否配置
if (!uri) {
  throw new Error('请在.env.local中配置MONGODB_URI');
}

if (process.env.NODE_ENV === 'development') {
  // 开发环境下Next.js热重载会重置模块缓存，所以把连接实例存在全局变量里
  if (!global._mongoClientPromise) {
    client = new MongoClient(uri, options);
    global._mongoClientPromise = client.connect();
  }
  clientPromise = global._mongoClientPromise;
} else {
  // 生产环境模块缓存稳定，直接创建连接
  client = new MongoClient(uri, options);
  clientPromise = client.connect();
}

export default clientPromise;

步骤2：在API路由中复用连接 #

比如在pages/api/data.js里调用：

import clientPromise from '../../lib/mongodb';

export default async function handler(req, res) {
  try {
    const client = await clientPromise;
    const db = client.db('你的数据库名');
    
    // 执行数据库操作，比如查询
    const result = await db.collection('你的集合名').find({}).toArray();
    
    res.status(200).json(result);
  } catch (error) {
    res.status(500).json({ error: '数据库操作失败' });
  }
}

为什么不用类似app.js的文件？ #

Next.js的API路由是按需执行的无服务器函数（或者说在Node.js环境下按需启动），不像Express有一个长期运行的主进程。但通过上面的单例封装，我们利用Node.js的模块缓存机制，确保整个应用生命周期内只会建立一次MongoDB连接，所有API调用共享这个连接池，完全达到和Express一样的效果。

额外提醒 #

• 确保MongoDB驱动版本和代码兼容，比如最新版驱动可能不需要useUnifiedTopology和useNewUrlParser选项，可以根据实际情况调整。
• 开发环境下的全局变量是为了避免热重载导致重复创建连接，生产环境不需要这一步。

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