MongoDB Atlas+Prisma+NextJS环境变量连接报错求助

问题概况 #

使用环境变量连接MongoDB Atlas时触发报错：

error: Error validating datasource db: the URL must start with the protocol mongo.

但直接将连接字符串硬编码到Prisma配置的url字段时，连接正常。现有配置如下：

Prisma Schema配置 #

datasource db {
  provider = "mongodb"
  url      = env("DATABASE_URL")
}

环境变量文件（.env/.env.local） #

DATABASE_URL=mongodb+srv://username:password@somemongodbserver/mydb?retryWrites=true&w=majority

已尝试的Next.js配置（无效） #

const nextConfig = {
  reactStrictMode: true,
  swcMinify: true,
  env: {
    DATABASE_URL: process.env.DATABASE_URL,
  },
};

解决方案 #

• 重启开发服务器：环境变量修改后必须重启Next.js开发服务才能生效，这是最常见的原因。
• 移除next.config.js中的env配置：Next.js 9.4+会自动加载根目录的.env/.env.local文件，手动配置env字段会干扰Prisma读取环境变量的上下文（Prisma在构建/生成阶段读取的是系统环境变量，而非Next.js客户端暴露的变量）。
• 验证环境变量加载状态：在项目根目录终端执行对应命令，确认环境变量能被读取：
  • Mac/Linux：echo $DATABASE_URL
  • Windows：echo %DATABASE_URL%
    如果输出为空，检查文件是否在项目根目录、命名是否正确（必须以.env或.env.local开头）。
• 重新生成Prisma客户端：执行npx prisma generate，清除旧客户端缓存，确保基于最新环境变量生成代码。
• 检查连接字符串编码：若密码包含特殊字符（如@、:、&等），需进行URL编码（例如@替换为%40），避免环境变量解析时出现截断。

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