Next.js项目执行npm run build时出现@prisma/client未初始化错误，prisma generate无法解决

刚接触网站开发就遇到这种构建错误确实有点懵，我来帮你一步步拆解问题、解决它。这个错误的核心是生产构建时Prisma Client没有被正确生成或加载，虽然你已经运行了prisma generate，但可能是流程或配置上的小问题导致它没生效，我们从基础开始排查：

一、先确认Prisma与Supabase的基础配置是否正确 #

因为你用的是Supabase作为数据库，首先要确保Prisma能正确连接到它：

1. 打开prisma/schema.prisma文件，检查datasource块是否正确：

datasource db {
  provider = "postgresql" // Supabase是PostgreSQL数据库，这个要对应
  url      = env("DATABASE_URL")
}

2. 检查你的.env文件，DATABASE_URL必须是Supabase提供的PostgreSQL连接字符串（在Supabase控制台的「设置」→「数据库」里找，格式是postgres://[用户名]:[密码]@[主机地址]:5432/[数据库名]，要注意不是Supabase的API URL）。
3. 先在开发模式下验证Prisma是否能正常工作：运行npm run dev，如果页面能正常加载并获取数据，说明开发环境没问题，问题出在生产构建流程。

二、修改构建脚本，确保Prisma Client在构建前生成 #

你之前单独运行prisma generate可能没和Next.js的构建流程绑定，导致构建时用的还是旧的甚至未生成的Client。我们直接修改package.json的build脚本，让它先自动生成Client再构建：
打开项目根目录的package.json，找到scripts部分，把build改成：

"scripts": {
  "dev": "next dev",
  "build": "prisma generate && next build",
  "start": "next start",
  "lint": "next lint"
}

这样每次运行npm run build时，都会先执行prisma generate生成最新的Prisma Client，再执行Next.js的构建，从流程上避免Client缺失的问题。

三、清理旧缓存，重新安装依赖（关键步骤） #

有时候旧的构建缓存或Prisma Client缓存会导致问题，我们彻底清理一下：
在终端中运行以下命令（对应你的Mac环境）：

# 删除Next.js构建缓存
rm -rf .next
# 删除旧的Prisma Client文件
rm -rf node_modules/.prisma
# 重新安装依赖
npm install

完成后再运行npm run build试试，这一步很多时候能解决“明明执行了generate但还是报错”的问题。

四、检查你的Prisma Client初始化代码（微调优化） #

你当前的src/lib/prisma.ts代码其实是Next.js中推荐的全局实例写法，没问题，但可以加个小优化，确保生产环境中Prisma Client的日志能帮你排查问题：

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

let prisma: PrismaClient;

declare global {
  var prisma: PrismaClient | undefined;
}

if (process.env.NODE_ENV === "production") {
  // 生产环境开启日志，方便排查连接问题
  prisma = new PrismaClient({
    log: ["query", "error"]
  });
} else {
  if (!global.prisma) {
    global.prisma = new PrismaClient();
  }
  prisma = global.prisma;
}

export default prisma;

这一步不是必须的，但如果之后还有问题，日志能帮你快速定位是连接问题还是Client初始化问题。

五、最后验证：先确保开发环境能正常运行 #

在尝试构建前，先运行npm run dev，如果主页能正常加载并显示数据（即使是空列表），说明Prisma Client在开发环境是正常的。如果dev模式也报错，那可能是Supabase的连接字符串不对，或者prisma/schema.prisma中的模型定义和数据库不匹配，这时候可以运行prisma db push同步schema到Supabase，再启动dev服务。

按照这几个步骤一步步来，应该就能解决构建时的Prisma Client未初始化问题了。如果还是有问题，可以把prisma generate的输出结果贴出来，我们再进一步排查~

内容来源于stack exchange