Prisma迁移PostgreSQL时触发外键约束异常排查

问题根源 #

Prisma迁移依赖影子数据库校验脚本合法性，而影子数据库仅同步迁移脚本中的操作，不会加载种子文件插入的Topic数据。迁移脚本中引用的topicId在影子库中不存在，因此触发Prompt_topicId_fkey外键约束错误。

具体解决步骤 #

• 将种子数据移入迁移脚本（推荐）
  如果Topic的数据是系统运行必需的基础数据（而非测试用临时数据），直接把插入Topic的SQL放到迁移文件中。这样影子数据库执行迁移时会自动创建这些数据，外键关联就能正常匹配。
  示例迁移SQL：

  INSERT INTO "Topic" ("id", "name") VALUES 
  (1, '前端开发'), 
  (2, '后端架构');
  

  注意：如果Topic表是之前的迁移创建的，可以新增一个专门插入基础数据的迁移文件，或者在创建Topic表的迁移文件末尾追加这段插入逻辑。

• 临时指定影子数据库为现有开发库（仅临时调试用）
  不想修改迁移脚本时，可以让Prisma直接用你的开发数据库作为影子库，跳过空影子库的校验。执行迁移时添加参数：

  prisma migrate dev --shadow-db-url "postgresql://your-user:your-password@localhost:5432/your-dev-db"
  

  警告：此方法可能会对开发数据库造成意外修改，仅适合本地调试，禁止在生产环境使用。

• 手动给影子数据库添加Topic数据
  找到Prisma自动创建的影子数据库（通常名称格式为prisma_migrate_shadow_xxxxxx），手动执行种子文件中的SQL插入Topic数据，再重新运行迁移。但影子数据库可能会被Prisma自动销毁重建，此方法仅能临时解决单次迁移问题。

关键注意事项 #

• Prisma迁移与种子文件的职责要明确：迁移负责管理数据库schema和必需的基础数据，种子文件仅用于填充测试数据或非必需的初始数据。不要在迁移脚本中依赖种子文件生成的数据，这会导致影子数据库校验失败。

内容的提问来源于stack exchange，提问作者Captain Condor