EF Core迁移PostgreSQL时BuildingStory外键约束违规错误如何解决？

BuildingStory 表已存在存量数据，本次迁移同时执行了三个操作：1. 新建空的 Buildings 表 2. 给 BuildingStory 新增非空必填字段 BuildingId 3. 新增两张表之间的必填外键约束。存量 BuildingStory 数据的 BuildingId 字段为默认空/无效值，且 Buildings 表无匹配的主键数据，因此创建外键时触发约束校验失败。

• 方案一：分步骤迁移+手动回填数据（推荐生产环境使用）

  1. 先暂时删除外键配置中的 IsRequired()，同时将实体类中的 BuildingId 改为可空类型 Guid?，生成第一次迁移。本次迁移仅新增可空的 BuildingId 字段和 Buildings 表，不加强制外键约束，执行 update-database 即可成功入库。
  2. 按照业务逻辑向 Buildings 表插入基础数据，同时给所有存量 BuildingStory 的 BuildingId 字段回填匹配的 Building 主键ID，保证每一条 BuildingStory 的 BuildingId+ProjectNumber 组合都能在 Buildings 表找到对应记录。
  3. 改回配置：将 BuildingId 恢复为非空 Guid 类型，外键配置恢复 IsRequired()，生成第二次迁移后再次执行 update-database，即可成功创建外键约束。

• 方案二：修改迁移文件插入自定义SQL预处理数据
  无需修改实体配置，直接修改EF Core自动生成的迁移文件，在创建外键的代码之前插入SQL语句完成数据初始化：

  // 1. 为所有存量ProjectNumber创建对应的默认Building记录
  migrationBuilder.Sql(@"
  INSERT INTO ""Buildings"" (""Id"", ""ProjectNumber"")
  SELECT DISTINCT gen_random_uuid(), ""ProjectNumber"" 
  FROM ""BuildingStories""
  ON CONFLICT DO NOTHING;
  ");
  
  // 2. 批量回填BuildingStory的BuildingId字段
  migrationBuilder.Sql(@"
  UPDATE ""BuildingStories"" bs
  SET ""BuildingId"" = b.""Id""
  FROM ""Buildings"" b
  WHERE bs.""ProjectNumber"" = b.""ProjectNumber"";
  ");
  
  // 原有自动生成的AddForeignKey代码放在此处之后执行
  

  注意：如果业务逻辑中一个ProjectNumber对应多个Building，需要自行调整上述SQL的匹配规则，保证BuildingId回填的正确性。

• 方案三：临时禁用外键约束校验（仅开发环境可用）
  如果是本地开发测试环境，存量数据为测试数据无需保证业务正确性，可以在迁移开头临时关闭PostgreSQL外键校验，执行完迁移逻辑后再恢复：

  // 迁移开头添加
  migrationBuilder.Sql("SET session_replication_role = 'replica';");
  
  // 原有自动生成的迁移逻辑（建表、加字段、加外键）放在中间
  
  // 迁移末尾添加
  migrationBuilder.Sql("SET session_replication_role = 'origin';");
  

  警告：该方案会跳过外键校验，可能产生脏数据，生产环境严禁使用。

• 方案四：修改外键为可选约束（符合业务场景可使用）
  如果业务上允许存在没有关联Building的楼层，直接将实体类中的 BuildingId 改为可空类型 Guid?，同时删除外键配置中的 IsRequired() 即可。自动生成的迁移会创建可空外键，不会触发存量数据的约束报错。

内容的提问来源于stack exchange，提问作者Glory Raj