Skip to main content

Prisma重建迁移历史

通常，在本地进行数据库迁移：

npx prisma migrate dev --name xxx

线上代码部署后，执行下面的命令完成线上数据库迁移：

npx prisma migrate deploy

Prisma 迁移历史丢失了！​

这种情况发生的原因是：你的数据库中存在一个名为 _prisma_migrations 的表，记录了过去所有的迁移历史（那几十个 2025xxxx 的记录），但你本地的 prisma/migrations 文件夹为空。Prisma 发现数据库记录的迁移在本地找不到，因此认为发生了“漂移（Drift）”。

千万不要运行 prisma migrate reset，否则会清空所有数据。

按照以下步骤通过“基线化（Baselining）”来恢复迁移功能：

第一步：清理数据库中的迁移记录​

由于你本地的迁移文件已经丢失，且你想重新开始，我们需要让数据库“忘记”之前的迁移历史。

连接到你的数据库（使用 pgAdmin, TablePlus 或命令行），执行以下 SQL：

-- 删除所有旧的迁移记录，这样 Prisma 就会认为这是一个新起点
TRUNCATE TABLE _prisma_migrations;

第二步：创建初始迁移文件（基线）​

现在我们要根据当前的 schema.prisma 创建一个新的“起始”迁移文件，但不立即执行它（因为表已经在数据库里了）。

  1. 创建迁移文件夹（如果不存在）：

    mkdir -p prisma/migrations/0_init

  2. 使用 prisma migrate diff 生成当前 schema 的全量 SQL：

    npx prisma migrate diff \
      --from-empty \
      --to-schema-datamodel prisma/schema.prisma \
      --script > prisma/migrations/0_init/migration.sql

    这一步会把当前的模型定义生成为一个完整的 migration.sql 文件。

第三步：标记该迁移已完成（关键）​

我们需要告诉 Prisma：“这个 0_init 迁移已经应用过了，你不需要再往数据库里跑 SQL 了”。

执行以下命令：

npx prisma migrate resolve --applied 0_init

第四步：同步并验证​

现在你的本地文件（0_init）和数据库记录（_prisma_migrations 表里的一条记录）就同步了。

尝试运行：

npx prisma migrate dev

结果预测：

  • 如果你的 schema.prisma 和 数据库结构 完全一致，Prisma 会提示 Already in sync。
  • 如果你有细微改动，Prisma 会提示你创建一个新的迁移。

常见问题排查​

1. 如果执行 migrate resolve 报错找不到文件？ 确保目录结构如下：

prisma/
  schema.prisma
  migrations/
    0_init/
      migration.sql

2. 以后改了 schema 怎么办？ 现在迁移功能已经恢复了。以后只需正常运行：

npx prisma migrate dev --name add_new_field

3. 为什么不直接用 migrate dev --create-only？ 因为当数据库中存在 _prisma_migrations 记录而本地没有文件时，Prisma 的安全机制会强制要求 reset。手动清空该表并 resolve 是绕过此机制且保护数据的标准做法。

建议： 修复完成后，务必将新的 migrations 文件夹提交到 Git 仓库，防止再次丢失。