Vercel Serverless函数因数据库连接耗尽频发15秒超时错误求助

核心问题定位 #

当前Vercel日志的「Task timed out after 15.02 seconds」与CloudWatch中PGBouncer的「client unexpected eof」错误高度关联，本质是Serverless函数创建的数据库连接未被正确回收，导致连接池耗尽，新请求排队超时。结合你的架构：

• 每个Vercel Lambda函数实例会创建7个Prisma连接
• PGBouncer的配置未适配Serverless短生命周期、按需扩容的特性，大量闲置连接占用了资源

针对性解决方案 #

1. 调整PGBouncer核心配置（优先操作） #

针对Serverless场景，修改PGBouncer配置适配短生命周期函数：

• 降低pg_bouncer_idle_transaction_timeout：从300秒改为10秒。之前的长超时无法快速回收卡住的事务连接，短超时能及时释放闲置连接
• 调小pg_bouncer_default_pool_size：从20降至5。Serverless函数会按需扩容，过大的池会导致连接被闲置占用
• 新增pg_bouncer_server_idle_timeout配置：设为30秒，自动回收PGBouncer到Postgres的闲置后端连接，避免Postgres侧连接耗尽
• 再次确认pg_bouncer_pool_mode为transaction：确保Prisma连接字符串已追加&pgbouncer=true，该模式下连接会在事务结束后立即归还连接池

2. 优化Prisma连接管理 #

即便已全局复用Prisma Client，Serverless环境仍需额外处理：

• 请求结束后显式断开连接：在SSR函数的请求逻辑完成后，手动调用prisma.$disconnect()。因为Serverless函数执行完即销毁，无需保持连接
• 限制单实例Prisma连接数：在Prisma Schema中添加connection_limit配置，比如设为5，减少单Lambda实例的连接占用：

  datasource db {
    provider = "postgresql"
    url      = env("DATABASE_URL")
    connection_limit = 5
  }
  

3. 优化Vercel函数配置 #

• 降低函数超时时间：从15秒改为10秒，快速终止卡住的请求，避免长时间占用连接资源
• 启用Provisioned Concurrency：Vercel专业版支持该功能，提前预热函数实例，减少冷启动时的连接创建波动，避免短时间内大量新连接冲击PGBouncer

4. 监控验证 #

• 在CloudWatch中监控PGBouncer核心指标：pool_wait_time（连接排队时间）、client_connections（活跃客户端连接数）、server_connections（到Postgres的连接数），确认配置调整后指标下降
• 在Vercel Dashboard中跟踪函数超时错误数，验证问题是否缓解

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