使用.NET Core Fluent API重命名SQL Server表时遇实体映射错误

问题原因 #

你遇到的情况是EF Core迁移生成器没识别出你要重命名表，反而误判为删除原Users表、新建AppUsers表并迁移数据。当迁移执行DeleteData操作时，你的实体已经通过Fluent API映射到AppUsers，EF找不到对应Users表的实体类型，因此抛出错误。

解决方案 #

1. 手动修改迁移文件 #

生成迁移后不要直接执行，打开生成的迁移文件（比如XXXX_RenameUsersToAppUsers.cs），做以下修改：

• 删除自动生成的DropTable("Users")、CreateTable("AppUsers")、DeleteData和InsertData相关代码
• 添加SQL Server的表重命名命令：

  protected override void Up(MigrationBuilder migrationBuilder)
  {
      // 替换原有代码为这一行
      migrationBuilder.Sql("EXEC sp_rename 'Users', 'AppUsers';");
  }
  
  protected override void Down(MigrationBuilder migrationBuilder)
  {
      // 可选：添加回滚操作
      migrationBuilder.Sql("EXEC sp_rename 'AppUsers', 'Users';");
  }
  

2. 适配数据种子（如果有） #

如果你在OnModelCreating里用了HasData做数据初始化，确保种子代码绑定的是User实体而非硬编码表名。EF会自动映射到新的AppUsers表，无需额外修改种子逻辑。

3. 重新执行迁移 #

• 如果已经执行过错误的迁移，先回滚到上一个正常状态：

  dotnet ef database update <上一个迁移的名称>
  

• 执行修改后的迁移：

  dotnet ef database update
  

额外注意事项 #

• 确认ApplicationDbContext中User实体的映射配置正确：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<User>().ToTable("AppUsers");
      // 其他实体配置...
  }
  

• 无需反复删除重建迁移，手动修改迁移文件是处理带数据的表重命名场景的标准方式——EF Core对这类操作的自动识别支持有限，尤其是涉及现有数据时。

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