数据迁移中的数据校验与错误上报方案咨询

1. 能否在迁移中执行未知产品名称的校验？ #

MigrationBuilder.Sql()确实无法直接返回查询结果，但有两种可行的校验方式：

• 纯SQL校验：在自定义SQL中用COUNT()或EXISTS()检测未匹配的采购订单，触发校验逻辑，示例代码：

  IF EXISTS(SELECT 1 FROM PurchaseOrders po WHERE NOT EXISTS(SELECT 1 FROM Products p WHERE p.Name = po.ProductName))
  BEGIN
      THROW 50001, '存在未匹配产品名称的采购订单，请先添加缺失产品', 1;
  END
  

  将这段SQL通过MigrationBuilder.Sql()执行即可在迁移过程中完成校验。
• ADO.NET直接查询：在迁移类的Up()方法中，获取数据库连接执行查询，直接获取未匹配记录的数量：

  using (var connection = this.Context.Database.GetDbConnection())
  {
      connection.Open();
      using (var command = connection.CreateCommand())
      {
          command.CommandText = "SELECT COUNT(*) FROM PurchaseOrders po WHERE NOT EXISTS(SELECT 1 FROM Products p WHERE p.Name = po.ProductName)";
          var count = (int)command.ExecuteScalar();
          if (count > 0)
          {
              // 执行后续报错或处理逻辑
          }
      }
  }
  

2. 能否直接抛出异常？迁移能否优雅恢复？ #

可以直接抛出异常，EF Core默认会在事务中执行迁移，抛出异常后整个迁移事务会自动回滚，不会留下半完成的数据库变更状态，属于优雅恢复的范畴。

• 注意：如果迁移中显式通过MigrationBuilder.Sql(sql, suppressTransaction: true)关闭了事务，那么抛出异常后已执行的无事务SQL不会回滚，这种情况需要自行处理事务边界。

3. 相关实践案例与更优实现方案 #

分阶段迁移方案（推荐） #

将整个变更拆分为多步迁移，降低风险：

1. 第一阶段迁移：添加可空的ProductId外键列，编写SQL填充匹配的产品ID，同时标记未匹配记录（比如设ProductId为NULL，或新增IsInvalid字段标记）。
2. 执行校验脚本：检测未匹配记录，输出错误信息告知用户，要求补充缺失产品后重新执行数据填充。
3. 第二阶段迁移：确认所有记录匹配完成后，将ProductId设为非空，创建外键约束，最后删除原ProductName列。

预处理校验脚本 #

在正式迁移前，单独执行校验脚本（可写成控制台工具或PowerShell脚本），提前检测问题并告知用户，避免迁移中途失败。

临时种子数据方案（可选） #

若允许临时处理，可在迁移中自动创建“未知产品”条目，将未匹配的采购订单关联到该条目，同时记录未匹配的产品名称日志，提示用户后续修正：

INSERT INTO Products (Name) SELECT DISTINCT po.ProductName FROM PurchaseOrders po WHERE NOT EXISTS(SELECT 1 FROM Products p WHERE p.Name = po.ProductName);
UPDATE PurchaseOrders po SET ProductId = (SELECT p.Id FROM Products p WHERE p.Name = po.ProductName);

这种方式不会中断迁移，但需后续人工清理临时数据。

内容的提问来源于stack exchange，提问作者Jonathan Wood