EF Core迁移应用时如何完成数据迁移：单图片转多图片表场景

针对表结构拆分、数据迁移、字段重构的指定场景，核心是手动调整EF Core自动生成的迁移脚本，严格按照数据安全优先的顺序插入自定义迁移逻辑，具体实现步骤如下：

整体迁移顺序逻辑 #

必须遵循从上到下的依赖顺序，避免字段丢失、关联断裂：

• 先保留EF自动生成的新建Image表的代码，作为数据迁移的目标表
• 插入自定义逻辑迁移旧Item表的图片数据到新表
• 调整Label表的外键关联，完成旧ItemId关联到新ImageId的映射
• 最后执行旧字段的删除操作（Item表的图片相关字段、Label表的旧ItemId字段）

具体操作步骤 #

1. 生成基础迁移草稿 #

先按照变更后的表结构完成实体类定义，执行Add-Migration生成初始迁移脚本。此时EF默认生成的逻辑包含：创建Image表、删除Item表的Image/ImageWidth/ImageHeight字段、修改Label表的外键关联，我们需要手动调整这个脚本的Up方法，插入数据迁移逻辑。

2. 调整Up方法的执行流程 #

按顺序把自定义逻辑插入到正确位置：

• 保留脚本最开头创建Image表的代码，这是后续数据插入的基础
• 插入第一块自定义迁移逻辑：把旧Item表的图片数据写入新的Image表
  这里用原生SQL实现数据拷贝，注意过滤掉图片为空的无效记录：

  migrationBuilder.Sql(@"
      INSERT INTO Images (ItemId, Image, ImageWidth, ImageHeight)
      SELECT Id, Image, ImageWidth, ImageHeight
      FROM Items
      WHERE Image IS NOT NULL;
  ");
  

• 插入第二块自定义逻辑：处理Label表的外键迁移
  因为原有Label是关联ItemId，现在要改成关联ImageId，不能直接删除旧的ItemId字段，需要先建立临时映射：

  // 给Label表添加可空的临时ImageId字段
  migrationBuilder.AddColumn<int>(
      name: "ImageId",
      table: "Labels",
      nullable: true);
  
  // 根据原有Label的ItemId，匹配刚才插入的对应Item的唯一图片记录，写入ImageId关联值
  migrationBuilder.Sql(@"
      UPDATE Labels
      SET ImageId = i.Id
      FROM Labels l
      INNER JOIN Images i ON l.ItemId = i.ItemId;
  ");
  
  // 确认所有Label都关联到有效Image后，将ImageId设为非空约束
  migrationBuilder.Sql(@"
      ALTER TABLE Labels ALTER COLUMN ImageId int NOT NULL;
  ");
  

• 把EF默认生成的、删除Item表旧图片字段、删除Label表旧ItemId字段、创建新外键约束的代码移动到整个流程的最后执行。

注意事项 #

• 执行迁移前务必备份生产数据库，避免脚本逻辑错误导致数据丢失。
• 边界值处理：如果存在Image为空的Item记录，迁移时会被自动过滤不会生成空的Image记录；如果存在Label对应的Item完全没有图片数据的情况，需要提前在迁移前做数据校验，根据业务规则处理这类异常数据，避免设置非空约束时报错。
• 数据库语法适配：上述关联更新的SQL是SQL Server的写法，使用PostgreSQL、MySQL等其他数据库时，需要调整对应的关联更新语法，避免脚本执行失败。
• 回滚逻辑调整：同步修改迁移脚本的Down方法，保证回滚时可以反向把Image表的图片数据同步回Item表、把Label的关联改回ItemId、再删除Image表，避免回滚后数据丢失。
• 迁移过程校验：可以在每步数据操作完成后加简单的统计查询，校验数据量是否符合预期（比如插入Image后，Image表的记录数应该等于原有Item表中有有效图片的记录数），提前发现迁移异常。

内容的提问来源于stack exchange，提问作者Roy Berris