如何解决CockroachDB中Prisma ORM字段设为非空后的漂移问题？

问题核心 #

迁移历史记录中file_link_id被设为必填，但当前Prisma Schema里该字段被改为可空，而数据库实际状态仍为必填。Prisma对比迁移历史的预期Schema与数据库实际Schema时，触发了漂移错误。

解决步骤 #

1. 确认数据库实际状态 #

执行SQL命令查看FontVariant表中file_link_id的约束状态：

SELECT column_name, is_nullable 
FROM information_schema.columns 
WHERE table_name = 'FontVariant' AND column_name = 'file_link_id';

若结果显示is_nullable = NO，说明数据库中该字段确实为必填，与迁移历史一致，但和当前Schema冲突。

2. 生成并应用新迁移（推荐方案） #

既然当前Schema需要file_link_id为可空，生成新迁移同步数据库状态：

• 生成仅包含迁移文件的命令：

  prisma migrate dev --create-only
  

• 打开生成的迁移文件，确认内容如下（自动生成的内容需匹配需求）：

  -- DropForeignKey
  ALTER TABLE "FontVariant" DROP CONSTRAINT "FontVariant_file_link_id_fkey";
  
  -- AlterTable
  ALTER TABLE "FontVariant" ALTER COLUMN "file_link_id" DROP NOT NULL;
  
  -- AddForeignKey
  ALTER TABLE "FontVariant" ADD CONSTRAINT "FontVariant_file_link_id_fkey" FOREIGN KEY ("file_link_id") REFERENCES "FileLink"("id") ON DELETE SET NULL ON UPDATE CASCADE;
  

  注意：外键的ON DELETE需改为SET NULL，适配字段可空的规则。

• 应用迁移：

  prisma migrate dev
  

执行完成后，数据库file_link_id会变为可空，与当前Schema一致，漂移错误将消失。

3. 修正迁移历史（仅特殊场景使用） #

若不想生成新迁移，可手动调整迁移历史（风险较高）：

• 确认_prisma_migrations表中，20250714220438_font_file_link_is_no_longer_optional已标记为applied。
• 修改该迁移文件的SQL内容：将ALTER COLUMN "file_link_id" SET NOT NULL改为ALTER COLUMN "file_link_id" DROP NOT NULL，同时调整外键ON DELETE规则为SET NULL。
• 重新同步迁移历史：

  prisma migrate resolve --applied 20250714220438_font_file_link_is_no_longer_optional
  

此方法可能引发后续迁移异常，仅在无法生成新迁移时使用。

4. 验证修复结果 #

运行命令确认Schema与数据库同步：

prisma migrate status

若输出显示Your database is in sync with your migration history.，则修复成功。

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