如何在PrismaJS中切换开发/生产环境数据库并保持Schema与迁移一致？

1. 配置多环境数据库连接 #

在prisma/schema.prisma中，通过环境变量动态指定数据库驱动和连接地址：

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

generator client {
  provider = "prisma-client-js"
}

创建两个环境配置文件：

• .env.development（开发环境）：

DATABASE_PROVIDER="sqlite"
DATABASE_URL="file:./dev.db"

• .env.production（生产环境）：

DATABASE_PROVIDER="mysql"
DATABASE_URL="mysql://[用户名]:[密码]@[主机地址]:3306/[数据库名]"

2. 编写兼容双数据库的Schema #

SQLite和MySQL存在部分语法差异，编写Schema时需遵循Prisma的跨数据库兼容规范：

• 优先使用Prisma通用类型，比如用@default(autoincrement())替代数据库原生自增语法，Prisma会自动适配SQLite的AUTOINCREMENT和MySQL的AUTO_INCREMENT
• 避免使用数据库专属类型（比如MySQL的ENUM可替换为Prisma枚举类型，Prisma会转成对应数据库的兼容实现）
• 时间字段用@default(now())，Prisma会自动生成SQLite的datetime('now')和MySQL的CURRENT_TIMESTAMP

示例兼容Schema：

model User {
  id    Int     @id @default(autoincrement())
  name  String
  email String  @unique
  posts Post[]
}

model Post {
  id        Int      @id @default(autoincrement())
  title     String
  content   String?
  published Boolean  @default(false)
  author    User     @relation(fields: [authorId], references: [id])
  authorId  Int
  createdAt DateTime @default(now())
}

3. 分环境管理迁移文件 #

Prisma迁移文件与数据库类型绑定，因此需要为SQLite和MySQL分别维护迁移目录：

生成开发环境（SQLite）迁移 #

加载开发环境变量并生成迁移：

# Linux/macOS
export $(cat .env.development | xargs)
prisma migrate dev --name init --schema ./prisma/schema.prisma

# Windows（需提前安装cross-env）
cross-env-shell "$(type .env.development)" prisma migrate dev --name init --schema ./prisma/schema.prisma

默认迁移文件会生成在prisma/migrations目录下。

生成生产环境（MySQL）迁移 #

加载生产环境变量，指定单独的迁移目录生成MySQL兼容的迁移：

# Linux/macOS
export $(cat .env.production | xargs)
prisma migrate dev --name init --schema ./prisma/schema.prisma --migrations-dir ./prisma/migrations/mysql

# Windows
cross-env-shell "$(type .env.production)" prisma migrate dev --name init --schema ./prisma/schema.prisma --migrations-dir ./prisma/migrations/mysql

后续修改Schema后，重复上述命令更新对应环境的迁移文件即可。

生产环境部署迁移 #

部署到生产环境时，执行MySQL迁移：

# Linux/macOS
export $(cat .env.production | xargs)
prisma migrate deploy --migrations-dir ./prisma/migrations/mysql

# Windows
cross-env-shell "$(type .env.production)" prisma migrate deploy --migrations-dir ./prisma/migrations/mysql

4. 简化环境切换操作（可选） #

在package.json中添加脚本，快速执行不同环境的命令：

{
  "scripts": {
    "dev:migrate": "cross-env-shell \"$(cat .env.development) prisma migrate dev --schema ./prisma/schema.prisma\"",
    "prod:migrate:dev": "cross-env-shell \"$(cat .env.production) prisma migrate dev --migrations-dir ./prisma/migrations/mysql\"",
    "prod:migrate:deploy": "cross-env-shell \"$(cat .env.production) prisma migrate deploy --migrations-dir ./prisma/migrations/mysql\"",
    "dev:studio": "cross-env-shell \"$(cat .env.development) prisma studio\"",
    "prod:studio": "cross-env-shell \"$(cat .env.production) prisma studio\""
  }
}

执行时只需运行npm run dev:migrate或npm run prod:migrate:deploy即可。

注意事项 #

• 每次修改Schema后，需分别为两个数据库生成迁移，确保逻辑一致
• 若需要迁移开发环境数据到生产，可使用prisma db dump导出SQLite数据，转换为MySQL兼容格式后导入
• 测试时需同时验证两个数据库的Schema兼容性，避免出现生产环境报错

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