Entity Framework Core重命名MySQL数据库列失败求助

问题场景 #

使用.NET 7.0、Entity Framework Core 7.0.5和MySQL时，通过Add-Migration <name>生成包含RenameColumn操作的迁移：

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.RenameColumn(
        name: "OldName",
        table: "MyTable",
        newName: "NewName");
}

执行Update-Database时触发NullReferenceException，报错栈如下：

Object reference not set to an instance of an object.
Applying migration '20230506191317_mymigration'.
System.NullReferenceException: Object reference not set to an instance of an object.
at MySql.EntityFrameworkCore.Migrations.MySQLMigrationsSqlGenerator.Generate(RenameColumnOperation operation, IModel model, MigrationCommandListBuilder builder)
...

移除RenameColumn命令后迁移可正常执行，且ModelSnapshot同步正常。

解决方案 #

1. 升级MySQL.EntityFrameworkCore版本 #

该问题是MySQL EF Core Provider的已知bug，在7.0.6及以上版本已修复。执行包管理器控制台命令升级：

Install-Package MySql.EntityFrameworkCore -Version 7.0.6

或直接修改项目文件中的包版本号后执行dotnet restore。

2. 手动修改迁移文件补充Schema参数 #

若暂时无法升级，可手动给RenameColumn操作添加显式的schema参数（MySQL默认schema通常为dbo或数据库名，根据实际情况填写）：

protected override void Up(MigrationBuilder migrationBuilder)
{
    migrationBuilder.RenameColumn(
        name: "OldName",
        table: "MyTable",
        newName: "NewName",
        schema: "dbo"); // 替换为你的实际schema名称
}

同时记得在Down方法中也补充对应的schema参数，确保回退逻辑正常。

3. 绕过自动迁移，执行原生SQL #

保留迁移文件但注释掉自动生成的RenameColumn代码，直接在Up和Down方法中执行原生MySQL SQL语句：

protected override void Up(MigrationBuilder migrationBuilder)
{
    // 注释自动生成的RenameColumn操作
    // migrationBuilder.RenameColumn(...);
    // 替换为实际的列类型，比如VARCHAR(255)、INT等
    migrationBuilder.Sql("ALTER TABLE `MyTable` CHANGE `OldName` `NewName` VARCHAR(255);");
}

protected override void Down(MigrationBuilder migrationBuilder)
{
    // 注释自动生成的回退操作
    // migrationBuilder.RenameColumn(...);
    migrationBuilder.Sql("ALTER TABLE `MyTable` CHANGE `NewName` `OldName` VARCHAR(255);");
}

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