部署Vercel后本地开发出现SCRAM认证失败错误

本地开发时触发以下错误，但Vercel部署环境正常：

Error occurred during query execution:
ConnectorError(ConnectorError { user_facing_error: None, kind: AuthenticationFailed { user: "SCRAM failure: bad auth : authentication failed" }, transient: false })
at async Page (./app/dashboard/[...folder]/page.tsx:49:16)
digest: "1029893487"
⨯ PrismaClientUnknownRequestError:
Invalid prisma.cafe.findUnique() invocation:

排查解决步骤 #

• 核对本地数据库认证信息
  检查本地.env文件中的DATABASE_URL，确认用户名、密码、数据库名称和本地数据库实例的配置完全匹配，SCRAM认证失败核心原因是账号密码不匹配或用户无库访问权限。
• 验证本地数据库连通性
  用数据库客户端（如pgAdmin、MySQL Workbench）直接使用本地配置的账号密码连接数据库，确认能正常访问并查询cafe表。
• 同步Prisma Schema与本地数据库结构
  本地执行prisma db push或prisma migrate dev，确保Schema定义的cafe模型和本地数据库表结构完全一致，结构不匹配会导致findUnique调用参数无效。
• 重新生成Prisma Client
  删除node_modules/.prisma文件夹，执行prisma generate，确保本地生成的Prisma Client基于最新Schema和环境配置。
• 确认本地环境变量加载有效性
  检查本地开发服务器是否正确加载了环境配置文件（如Next.js的.env.local），避免变量名拼写错误、多余引号等问题导致配置未生效。
• 检查数据库用户权限
  确认本地数据库用户拥有cafe表的SELECT权限，SCRAM认证通过后权限不足也会触发请求错误。

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