Next.js使用Prisma作为ORM触发数据库角色连接数过多报错

你遇到的报错：

Error querying the database: db error: FATAL: too many connections for role "qcjoaamjgbnxjx"

核心原因是Next.js开发环境的热重载机制，每次代码变更重新加载模块时，你现有的初始化代码都会创建一个全新的PrismaClient实例，每个实例会独立占用数据库连接池的连接，累计超过数据库角色的最大连接数限制就会触发该报错。生产环境没有热重载逻辑，默认不会触发该问题，但也推荐使用下方的最佳实践初始化客户端。

修改lib目录下的Prisma初始化代码，将实例挂载到全局对象上，热重载时优先复用已存在的实例，避免重复创建：

import { PrismaClient } from '@prisma/client';

const globalForPrisma = globalThis;

const prisma = globalForPrisma.prisma ?? new PrismaClient();

if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;

export default prisma;

如果是TypeScript项目，可以补充类型定义：

import { PrismaClient } from '@prisma/client';

const globalForPrisma = globalThis as unknown as {
  prisma: PrismaClient | undefined;
};

const prisma = globalForPrisma.prisma ?? new PrismaClient();

if (process.env.NODE_ENV !== 'production') globalForPrisma.prisma = prisma;

export default prisma;

• 检查数据库角色的最大连接数限制：多数云数据库免费套餐的单角色最大连接数在10~20区间，可以在数据库管理后台确认当前上限，避免配置的连接池大小超过上限
• 显式调整Prisma连接池大小：可以在数据库连接字符串末尾追加参数?connection_limit=5，将Prisma单实例的连接池大小限制在合理范围
• 排查长连接场景占用：确认是否存在定时任务、WebSocket长连接等场景长期持有Prisma连接未释放的情况
• Edge Runtime场景单独初始化：如果你的项目中有用到Edge Runtime的接口，不要复用Node.js环境下的Prisma实例，需要单独适配初始化逻辑

内容的提问来源于stack exchange，提问作者Harsha M V