如何在Next.js开发环境中创建单一Prisma实例？

嘿，我之前也踩过这个坑！Next.js的热重载机制在开发时会频繁重启模块，要是处理不好Prisma Client的实例化，就会像你说的那样，冒出来一堆重复的连接初始化日志，还会创建多个数据库连接实例，既浪费资源又容易出现莫名的问题。

其实你现在的思路方向是对的——核心就是利用Node.js的全局对象来持久化Prisma实例，避免热重载时重复创建。我给你调整了更严谨的代码，再仔细拆解每一步的作用：

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

// 给TypeScript声明全局变量类型，避免类型报错，JS项目可省略这部分
declare global {
  var prisma: PrismaClient | undefined;
}

// 封装创建Prisma实例的逻辑
const createPrismaClient = () => {
  console.log('数据库连接已初始化');
  return new PrismaClient({
    // 可选：开发时可开启日志方便调试，生产建议关闭
    // log: ['query', 'info', 'warn', 'error'],
  });
};

// 优先复用全局已有的实例，无实例时再创建新的
const db = global.prisma || createPrismaClient();

// 仅在开发环境将实例挂载到全局，生产环境Next.js会自动优化单例
if (process.env.NODE_ENV !== "production") {
  global.prisma = db;
}

export default db;

再给你划几个关键要点：

• 全局变量的作用：Next.js热重载时，模块会被重新执行，但Node.js的全局对象不会被销毁，所以把Prisma实例挂在全局上，就能在重载时复用已有实例，避免重复创建。
• 类型声明的必要性：如果是TypeScript项目，declare global是必须的，不然TypeScript会报错说全局对象上没有prisma属性；纯JavaScript项目可以直接删掉这部分。
• 生产环境的处理：生产环境下Next.js的模块加载机制会自动保证单例，不需要挂载到全局，所以我们只在开发环境做这个操作。

最后再提个小提醒：项目里所有需要操作数据库的地方，都要通过这个统一文件导出的db实例来调用，千万不要在API路由、组件里直接new PrismaClient()，不然又会回到重复创建的问题。

内容来源于stack exchange