Next.js+Vercel Supabase Postgres连接意外终止异常求助

问题根源 #

你当前的代码在模块级别初始化数据库连接（const client = await db.connect();写在API路由函数外），这在Next.js无服务器环境下会触发两个核心问题：

1. 模块级代码仅在路由首次冷启动时执行，后续请求复用同一个连接，而无服务器平台会自动回收闲置连接，导致连接意外终止。
2. 连接层面的异常属于事件循环抛出的未捕获错误，无法被API函数内的catch块捕获，直接导致Node进程退出。

具体解决方案 #

1. 改用内置连接池管理，避免手动创建连接

@vercel/postgres的db对象已经封装了连接池逻辑，直接使用db.sql无需手动调用connect()和release()，会自动从连接池获取/释放连接，彻底解决闲置连接被回收的问题：

import { db } from "@vercel/postgres";
import { NextRequest } from "next/server";

export async function GET(request: NextRequest) {
  try {
    const result = await db.sql`
      -- 你的SQL查询语句
    `;
    return Response.json({ data: result.rows });
  } catch (error) {
    console.error("数据库查询失败:", error);
    return Response.json({ error: "服务端错误" }, { status: 500 });
  }
}

2. 必须手动管理连接时的正确姿势

如果确实需要手动控制连接，务必将连接逻辑放在API函数内部，并在finally块中释放连接：

import { db } from "@vercel/postgres";
import { NextRequest } from "next/server";

export async function GET(request: NextRequest) {
  let client;
  try {
    client = await db.connect();
    const result = await client.sql`
      -- 你的SQL查询语句
    `;
    return Response.json({ data: result.rows });
  } catch (error) {
    console.error("数据库查询失败:", error);
    return Response.json({ error: "服务端错误" }, { status: 500 });
  } finally {
    // 确保连接返回连接池，避免资源泄漏
    if (client) client.release();
  }
}

3. 捕获全局未处理异常，防止进程退出

添加全局异常监听，捕获连接层面的未处理错误，避免Node进程直接崩溃：

// 在API路由顶部或项目入口文件中添加
process.on('uncaughtException', (error) => {
  console.error("未捕获异常:", error);
});

process.on('unhandledRejection', (reason) => {
  console.error("未处理Promise拒绝:", reason);
});

4. 优化SWR客户端重试逻辑

针对偶尔的请求失败，给SWR添加重试配置，提升用户体验：

const groups = useSWR<{ data: GroupResponse }, Error>(
  "/api/groups",
  fetcher,
  { 
    revalidateOnFocus: false,
    retry: 3, // 失败后最多重试3次
    retryDelay: (attempt) => Math.min(1000 * 2 ** attempt, 10000) // 指数退避延迟
  }
);

5. 排查Supabase连接限制

Supabase免费版有数据库连接数上限（通常为60），如果应用并发较高，可能导致连接池耗尽。可以在Supabase控制台查看数据库监控-连接数，确认是否达到限制，必要时升级套餐或优化请求并发量。

总结 #

无需更换数据库，核心问题是连接管理方式错误，改用@vercel/postgres内置的连接池逻辑，配合正确的错误捕获和客户端重试，即可解决大部分连接终止问题。

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