如何让MongoDB连接代码在Next.js启动时仅运行一次而非每次请求执行？

在Next.js中，直接在路由文件顶层编写数据库连接代码会导致每次请求（或开发模式热重载）都执行连接逻辑，这和你在Express中的需求不符。以下是实现仅在应用启动时初始化一次MongoDB连接的可靠方案：

1. 创建独立的数据库连接模块 #

新建一个专门处理Mongoose连接的文件，比如app/lib/mongoose.js（适配Next.js 13+的App Router结构），利用Node.js全局对象缓存连接状态，避免重复连接：

// app/lib/mongoose.js
import mongoose from 'mongoose';

// 建议从环境变量读取数据库地址，避免硬编码
const MONGODB_URI = process.env.MONGODB_URI || 'mongodb://localhost:27017/user';

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

// 全局缓存连接实例，防止开发模式热重载重复创建连接
let cached = global.mongoose;
if (!cached) {
  cached = global.mongoose = { conn: null, promise: null };
}

async function connect() {
  // 如果已有连接，直接返回
  if (cached.conn) {
    return cached.conn;
  }

  // 如果正在连接中，等待连接完成
  if (!cached.promise) {
    const opts = {
      bufferCommands: false, // 禁用命令缓冲，避免连接未就绪时的报错
    };

    cached.promise = mongoose.connect(MONGODB_URI, opts).then((mongooseInstance) => {
      return mongooseInstance;
    });
  }

  try {
    cached.conn = await cached.promise;
  } catch (error) {
    cached.promise = null; // 连接失败时清空缓存，下次可重试
    throw error;
  }

  return cached.conn;
}

export default connect;

2. 在路由/服务器组件中使用连接 #

在需要数据库操作的路由文件（比如app/route.js）中，导入并调用连接函数。由于连接已被缓存，多次调用只会实际执行一次连接逻辑：

// app/route.js
import { NextResponse } from 'next/server';
import connect from './lib/mongoose';

export async function POST(request: Request) {
  // 确保数据库连接已建立（仅首次调用时会执行实际连接）
  await connect();

  const res = await request.json();
  console.log(request);
  console.log(res);
  return NextResponse.json({ hello: 'world' });
}

关键原理说明 #

• 全局缓存：利用Node.js的global对象存储连接实例，在开发模式热重载时，模块会重新执行，但global中的缓存不会被清空，因此能保持单一连接。
• 连接状态判断：通过检查缓存的conn和promise，避免重复发起连接请求，即使多个路由同时调用connect函数，也会共享同一个连接实例。
• Mongoose内置机制：Mongoose本身会对相同URI的连接进行缓存，但手动添加全局缓存能更明确地控制连接生命周期，尤其适配Next.js的开发模式。

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