Next.js API用Prisma插入MySQL数据连接数过多解决方法

连接数暴涨和prisma.[db_name].create()方法本身无关，核心原因是Prisma Client未做全局单例复用：

• Next.js开发模式的热重载（HMR）会反复重新执行模块代码，如果你在API路由内直接初始化new PrismaClient()，每次热重载、甚至每次请求处理都会生成全新的Prisma Client实例，每个实例会独立维护连接池，旧实例持有的数据库连接不会被主动释放，累计下来很快就会打满MySQL默认的500左右最大连接数，和你遇到的报错阈值完全匹配。
• 如果是生产环境Serverless部署，未做实例复用的话，每个函数冷启动都会生成新的Prisma实例，高并发下同样会冲垮数据库连接。

1. 实现Prisma Client全局单例 #

不要在每个API路由文件中单独初始化Prisma，新建全局实例入口文件lib/prisma.js（TS项目对应lib/prisma.ts），所有路由统一从这个文件引入Prisma实例：

// lib/prisma.js
import { PrismaClient } from '@prisma/client'

const prisma = globalThis.prisma || new PrismaClient()
if (process.env.NODE_ENV !== 'production') globalThis.prisma = prisma

export default prisma

逻辑说明：开发环境将Prisma实例挂载到Node.js全局对象globalThis上，热重载时直接复用已有实例，不会重复创建；生产环境直接生成单例使用，从根源上杜绝多实例导致的连接泄漏。
如果需要自定义连接池大小，可以在初始化PrismaClient时传入配置，常规业务场景默认配置即可满足需求，不需要盲目调大连接池：

new PrismaClient({
  datasources: {
    db: { url: process.env.DATABASE_URL }
  },
  // 连接池大小默认值为 CPU核心数*2 +1
  // connection_limit: 10
})

2. 修正API路由调用逻辑 #

你贴的代码存在拼写错误：wait prisma应为await prisma。所有API路由中不要重新初始化Prisma，统一从全局入口引入：

// App Router 示例：app/api/record/route.js
// Pages Router 对应路径为 pages/api/record.js
import prisma from '@/lib/prisma'

export async function PUT(request) {
  try {
    const body = await request.json()
    const result = await prisma.[db_name].create({
      data: body.[json_data_name]
    })
    return Response.json({ success: true, data: result })
  } catch (err) {
    return Response.json({ success: false, msg: err.message }, { status: 500 })
  }
}

3. 2000~3000条数据写入优化 #

• 如果是单次请求携带批量数据：不要循环调用create()方法，直接使用Prisma内置的createMany做批量写入，单次请求即可完成全量插入，连接占用和耗时比循环单条插入低90%以上：

  const result = await prisma.[db_name].createMany({
    data: [/* 待插入的2000~3000条数据组成的对象数组 */],
    skipDuplicates: true // 可选，遇到唯一键冲突时自动跳过不报错
  })
  

• 如果是**2000_{3000次独立PUT请求**：只要完成第一步的全局单例配置，Prisma默认的连接池（通常大小为5}10）完全可以承载这个量级的写入压力，不会出现连接数暴涨的问题。

可选兜底配置 #

如果仍偶发连接报错，可以检查MySQL侧的最大连接数配置，调整到适配业务的数值：

-- 查看当前最大连接数配置
SHOW VARIABLES LIKE 'max_connections';
-- 临时调整最大连接数为1000，重启MySQL后失效；永久生效需要修改MySQL的my.cnf配置文件
SET GLOBAL max_connections = 1000;

注意不要盲目调大max_connections，MySQL单个连接约占1M内存，过高的连接上限会导致MySQL内存溢出。

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