如何在不清除数据库的情况下同步超前于Prisma迁移的PSQL

当你直接通过PSQL修改数据库（比如给Appointment表加status字段），再更新Prisma Schema后，会出现迁移历史与实际数据库状态不匹配的情况，以下是无需清除数据库的同步方案：

步骤1：创建空迁移文件 #

先生成一个仅含框架的迁移文件，不实际执行变更（因为字段已经存在）：

prisma migrate dev --create-only

执行后会在prisma/migrations目录下生成带时间戳的空迁移文件夹，里面包含migration.sql和版本文件。

步骤2：填充对应迁移SQL #

打开刚生成的migration.sql，写入你之前手动在PSQL执行的字段添加语句，示例（根据实际字段类型调整）：

ALTER TABLE "Appointment" ADD COLUMN "status" TEXT NOT NULL DEFAULT 'scheduled';

如果字段允许为空，去掉NOT NULL DEFAULT 'scheduled'即可，确保SQL和你手动执行的完全一致。

步骤3：标记迁移已应用 #

告诉Prisma这个迁移已经在数据库上执行完成，无需重复运行：

prisma migrate resolve --applied <迁移文件名>

这里的<迁移文件名>是你刚创建的带时间戳的文件夹名称，比如20240520152000_add_status_to_appointment。

步骤4：验证同步结果 #

运行以下命令确认Prisma已识别到数据库、Schema与迁移历史完全一致：

prisma migrate dev

如果没有提示差异，说明同步完成。

注意事项 #

• 后续尽量避免手动修改数据库结构，所有变更通过Prisma迁移执行，防止再次出现状态不一致。
• 生产环境操作前务必备份数据库，且使用prisma migrate deploy而非prisma migrate dev，避免影响业务数据。

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