部署在Vercel的NextJS+MongoDB应用数据库连接数超限排查

我开发了一个基于NextJS与MongoDB的应用，部署至Vercel后发现数据库连接数迅速接近上限，这与此前基于Node+React开发时的情况截然不同。由于数据库连接逻辑已变更，我编写了如下连接函数，并在每个接口查询时调用它，请问我的实现是否存在问题？

连接函数代码 #

// lib/mongodb.ts
import mongoose from "mongoose";

// #TODO
// 我尝试把这段声明放到types/global.d.ts里
// 但一直遇到mongoose全局变量错误
// 所以移到了这里
// 不确定放在这里是否合理
declare global {
  var mongoose: {
    conn: any;
    promise: Promise<any> | null;
  };
}

const MONGODB_URI = process.env.MONGODB_URI;

if (!MONGODB_URI) {
  throw new Error("请配置MONGODB_URI环境变量");
}

let cached = global.mongoose;

if (!cached) {
  // conn: 已建立的连接
  // promise: 正在进行的连接尝试
  /**
     * cached.promise: 避免首次请求时连接未建立前，出现多个并发连接尝试
       cached.conn: 连接建立后，直接返回活跃连接提升响应速度
     */
  cached = global.mongoose = { conn: null, promise: null };
}

async function connectToDatabase() {
  /**
   * 已建立的连接存在于cached.conn中，后续请求可以直接跳过连接流程
   * 提升响应速度
   */
  if (cached.conn) {
    return cached.conn;
  }

  /**
   * 检查cached.promise避免重复发起连接请求
   * 如果已有连接尝试（promise），直接复用，减少数据库负载
   */
  if (!cached.promise) {
    /**
     * 将连接promise存入cached.promise，连接未完成前的后续请求可以等待同一个promise
     * 避免重复连接尝试
     */
    cached.promise = mongoose
      .connect(MONGODB_URI as string)
      .then((mongoose) => {
        return mongoose;
      })
      .catch((error) => {
        console.error("🚀 ~ MongoDB连接错误:", error);
        throw error; // 日志记录后重新抛出错误
      });
  }

  try {
    cached.conn = await cached.promise;
  } catch (error) {
    throw error;
  }

  return cached.conn;
}

export default connectToDatabase;

接口调用示例 #

export async function GET(request: Request) {
  const searchParams = await request.json();
  await connectToDatabase();

  try {
    const results = await searchInstructors(searchParams);
    return NextResponse.json(results);
  } catch (error) {
    return NextResponse.json({ error: "获取讲师列表失败" }, { status: 500 });
  }
}

问题分析与优化方案 #

你的连接缓存逻辑本身是正确的，但在Vercel的Serverless环境下，几个核心问题导致了连接数暴涨：

1. Vercel Serverless的无状态特性：每次请求可能触发新的函数实例启动，全局变量的缓存仅对当前实例有效。请求量上升时，Vercel会扩容多个实例，每个实例都会建立独立的MongoDB连接池，直接导致总连接数飙升。

2. 未配置连接池参数：Mongoose默认连接池大小为5，多个实例叠加后，很容易耗尽MongoDB的连接数上限。

3. 连接失败后的处理缺失：如果某次连接失败，cached.promise会一直保留失败状态，后续请求都会复用这个失败的promise，无法重新尝试连接。

优化后的连接函数 #

// lib/mongodb.ts
import mongoose from "mongoose";

declare global {
  var mongoose: {
    conn: mongoose.Mongoose | null;
    promise: Promise<mongoose.Mongoose> | null;
  };
}

const MONGODB_URI = process.env.MONGODB_URI;

if (!MONGODB_URI) {
  throw new Error("请配置MONGODB_URI环境变量");
}

let cached = global.mongoose;

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

async function connectToDatabase() {
  if (cached.conn) {
    return cached.conn;
  }

  if (!cached.promise) {
    const opts = {
      maxPoolSize: 2, // 降低每个实例的连接池大小，适配Serverless弹性环境
      serverSelectionTimeoutMS: 5000, // 缩短连接超时时间，快速失败重试
      socketTimeoutMS: 45000, // 调整Socket超时，避免闲置连接占用资源
    };

    cached.promise = mongoose.connect(MONGODB_URI, opts)
      .then((mongoose) => {
        console.log("MongoDB连接成功");
        return mongoose;
      })
      .catch((error) => {
        console.error("MongoDB连接失败:", error);
        cached.promise = null; // 连接失败后重置promise，允许后续请求重试
        throw error;
      });
  }

  try {
    cached.conn = await cached.promise;
  } catch (error) {
    cached.promise = null;
    throw error;
  }

  return cached.conn;
}

export default connectToDatabase;

额外建议 #

• 使用MongoDB Serverless实例：MongoDB Atlas的Serverless实例会动态调整连接数限制，更适配Vercel这类Serverless平台的弹性扩容特性。
• 模型加载时机：确保所有Mongoose模型都在调用connectToDatabase()之后导入，避免在连接未建立时重复初始化模型。
• 监控连接数：在MongoDB控制台实时监控连接数变化，根据实际请求量调整maxPoolSize参数。

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