Heroku部署Node.js+Prisma+MySQL项目时DATABASE_URL缺失问题

一、解决Prisma P1012（DATABASE_URL未找到）错误 #

1. 配置Heroku环境变量 #

Heroku不会自动读取仓库中的.env文件，必须通过平台控制台配置环境变量：

• 打开Heroku Dashboard，进入目标应用 → Settings → Config Vars
• 点击Reveal Config Vars，检查是否存在DATABASE_URL：
  • 若不存在，添加该变量，值填写ClearDB提供的完整数据库连接字符串（与你本地.env中的内容一致）
  • 若已存在，确认连接字符串格式正确，无多余引号或拼写错误

2. 移除仓库中的.env文件（关键） #

.env包含数据库密码、密钥等敏感信息，绝对不能提交到GitHub：

• 在项目根目录创建.gitignore文件（若无），添加一行：.env
• 从GitHub仓库中移除已提交的.env文件：执行git rm --cached .env，再提交并推送变更

3. 正确执行Prisma迁移 #

在Heroku上执行迁移推荐两种方式：

• 方式1：通过Heroku CLI手动执行
  本地终端运行：

  heroku run npx prisma migrate deploy
  

• 方式2：部署后自动执行（推荐）
  在package.json的scripts中添加postbuild脚本，让Heroku部署完成后自动运行迁移：

  "scripts": {
    "start": "node src/index.js",
    "build": "echo 'Build finished'",
    "postbuild": "npx prisma migrate deploy"
  }
  

4. 验证schema.prisma配置 #

确认schema.prisma中的数据库URL引用与环境变量名完全一致：

datasource db {
  provider = "mysql"
  url      = env("DATABASE_URL") // 变量名必须和Heroku Config Vars中的一致
}

二、解决根路由Cannot GET /问题 #

你的Express应用未定义根路径的GET路由，在主入口文件（如src/index.js）中添加以下代码：

app.get('/', (req, res) => {
  res.status(200).send('API is running successfully');
});

额外检查 #

• 确认ClearDB的数据库用户拥有CREATE、ALTER等迁移所需的权限
• 通过heroku logs --tail查看应用日志，排查是否存在其他隐藏错误

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