使用实体中Seed迁移旧库数据至新库失败，如何排查解决？

我来帮你一步步排查这个Seed迁移失效的问题，这种情况我之前也碰到过几次，大概率是某个环节的配置或逻辑没到位：

1. 先确认Seed代码是否真的执行了 #

首先得排除「代码根本没跑起来」的低级问题：

• 在Seed方法里加个简单的日志或控制台输出，比如Console.WriteLine("=== Seed方法开始执行 ===")，运行后看控制台/日志有没有这条信息。
• 检查项目启动时的执行顺序：比如ASP.NET Core中，是不是在context.Database.Migrate()/EnsureCreated()之后才调用Seed？顺序错了的话，Seed可能根本没触发。
• 如果用EF Core的迁移命令，要确认Seed逻辑是写在DbContext的OnModelCreating里，还是单独的扩展方法——有没有在启动代码里正确调用这个方法？

2. 验证旧数据库的连接与数据读取能力 #

Seed失效很多时候是没正确读到旧数据：

• 单独写个测试片段，用旧数据库的连接字符串直接查询，看能不能拿到数据：

  var oldConn = "你的旧数据库连接串";
  using var oldDb = new OldDbContext(new DbContextOptionsBuilder<OldDbContext>().UseSqlServer(oldConn).Options);
  var oldRecords = oldDb.TargetTable.ToList();
  Console.WriteLine($"读取到旧数据条数：{oldRecords.Count}");
  

  如果这里拿不到数据，那就是旧数据库的连接配置错了，或者数据库用户没有读权限。

3. 检查新数据库的实体映射与插入逻辑 #

新数据库结构变更后，实体和表的映射很容易出问题：

• 核对新实体类的属性和新数据库表的字段：有没有新增必填字段但Seed时没赋值？比如新表加了CreateTime且不允许为null，但迁移时没给这个字段设值，插入就会失败，若没捕获异常看起来就像「没反应」。
• 在插入代码块外层加try-catch，强制打印异常信息：

  try
  {
      foreach (var oldItem in oldRecords)
      {
          var newItem = new NewEntity
          {
              Id = oldItem.Id,
              Title = oldItem.Title,
              // 注意：新字段必须赋值，尤其是非空字段
              CreateTime = oldItem.CreateTime ?? DateTime.Now
          };
          newDb.NewEntities.Add(newItem);
      }
      await newDb.SaveChangesAsync();
      Console.WriteLine("数据迁移成功");
  }
  catch (Exception ex)
  {
      Console.WriteLine($"Seed失败原因：{ex.Message}");
      Console.WriteLine($"异常详情：{ex.InnerException?.Message}");
  }
  

  很多时候是插入时的约束冲突（比如重复主键、字段长度超限），但没捕获异常就看不到问题。

4. 确认事务与数据提交环节 #

• 如果你在Seed里用了事务，要确认事务有没有正确提交，有没有中途被Rollback的情况。
• 别漏了EF Core的SaveChanges()/SaveChangesAsync()！这步是把内存中的数据写入数据库的关键，没调用的话数据只会停留在内存里，不会落地到新库。

5. 检查数据库上下文的作用域 #

如果是依赖注入场景，要确认新DbContext的生命周期配置正确：比如ASP.NET Core中是不是用了Scoped生命周期？有没有在Seed时意外创建了多个上下文实例，导致插入的那个实例没被保存？

• 混淆Seed和迁移的概念：EF Core的HasData是在迁移时插入初始数据，如果你是从旧库迁移业务数据，这不适合用HasData，应该写单独的迁移脚本或控制台程序，而不是依赖模型构建器里的Seed。
• 忽略类型转换问题：比如旧库的DateTime是可空类型，新库是必填的非空类型，但旧数据里有null值，插入时就会报错。
• 数据库权限不足：新数据库的用户有没有插入权限？如果只给了读权限，写入会静默失败（有些场景下不会抛出明显异常）。

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