Next.js 13+中MongoDB Atlas数据库连接初始化位置咨询

1. 封装Mongoose连接逻辑 #

在项目根目录下新建lib/mongoose.js，把连接逻辑集中在这里，利用Mongoose的内置缓存机制确保只建立一次连接：

import mongoose from 'mongoose';

const MONGODB_URI = process.env.MONGODB_URI;

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

// 用全局变量缓存连接实例，避免重复连接
let cached = global.mongoose;

if (!cached) {
  cached = global.mongoose = { conn: null, promise: null };
}

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

  // 如果还没有连接请求，发起新的连接
  if (!cached.promise) {
    const opts = {
      bufferCommands: false,
    };

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

export default connectDB;

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

在任意服务器组件（比如app/page.js或自定义服务器组件）里，导入连接函数并在查询前调用即可——不用担心重复连接，函数内部会自动复用缓存的连接实例：

import connectDB from '@/lib/mongoose';
import User from '@/models/User'; // 你的Mongoose模型文件

export default async function Home() {
  await connectDB();
  const users = await User.find({});

  return (
    <div>
      <h1>用户列表</h1>
      <ul>
        {users.map(user => (
          <li key={user._id}>{user.name}</li>
        ))}
      </ul>
    </div>
  );
}

3. 模型文件的正确写法 #

模型文件（比如models/User.js）正常定义Schema即可，无需处理连接逻辑，因为连接会在查询前自动初始化：

import mongoose from 'mongoose';

const userSchema = new mongoose.Schema({
  name: String,
  email: { type: String, unique: true },
});

// 避免重复编译模型，检查是否已有同名模型
const User = mongoose.models.User || mongoose.model('User', userSchema);

export default User;

核心逻辑说明 #

Next.js 13+的App Router中，服务器组件会在每次请求时执行，但我们通过global对象缓存连接实例，确保第一次请求建立连接后，后续所有请求都会复用这个连接，和你在Express里把连接放在入口文件的效果一致——都是全局只维护一个数据库连接。

如果是API路由（app/api/...），同样可以用这个方式，在路由处理函数开头调用connectDB()即可。

内容的提问来源于stack exchange，提问作者oteiza-a