EF迁移中自定义SQL未执行，ExternalId列值全为0问题排查

问题场景 #

我在EF Core迁移中编写了以下代码：

migrationBuilder.AddColumn<int>(
    name: "ExternalId",
    table: "VariableType",
    type: "int",
    nullable: true);

migrationBuilder.Sql("UPDATE VariableType SET ExternalId = id_DescriptionType");

迁移执行成功后，VariableType表的ExternalId列所有值均为0，但id_DescriptionType列的所有行都是唯一非零值，手动执行这条UPDATE语句能得到预期结果。

若在迁移中追加创建唯一索引的代码：

migrationBuilder.CreateIndex(
    name: "IX_VariableType_ExternalId",
    table: "VariableType",
    column: "ExternalId",
    unique: true,
    filter: "[ExternalId] IS NOT NULL");

迁移会因ExternalId列值不唯一（全为0）而失败。

已尝试的无效方案：

• 创建列时设置nullable: false并指定默认值
• 给migrationBuilder.Sql添加suppressTransaction: true参数
• 在SQL语句末尾加分号

排查与解决方案 #

1. 确认SQL语句的实际执行内容 #

开启EF Core的数据库命令日志，查看迁移时实际执行的SQL语句是否与手动执行的一致：

// 在Program.cs/Startup.cs中配置日志
builder.Logging.AddFilter("Microsoft.EntityFrameworkCore.Database.Command", LogLevel.Information);

重点检查VariableType表名、id_DescriptionType列名是否与数据库实际命名匹配（EF Core可能因配置生成复数、大小写差异的命名）。

2. 拆分迁移步骤 #

将添加列、更新数据、创建索引的操作拆分为两个独立迁移：

第一个迁移：仅添加ExternalId列

public partial class AddExternalIdColumn : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.AddColumn<int>(
            name: "ExternalId",
            table: "VariableType",
            type: "int",
            nullable: true);
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DropColumn(name: "ExternalId", table: "VariableType");
    }
}

第二个迁移：填充数据并创建索引

public partial class PopulateExternalIdAndIndex : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.Sql("UPDATE VariableType SET ExternalId = id_DescriptionType");
        migrationBuilder.CreateIndex(
            name: "IX_VariableType_ExternalId",
            table: "VariableType",
            column: "ExternalId",
            unique: true,
            filter: "[ExternalId] IS NOT NULL");
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DropIndex(name: "IX_VariableType_ExternalId", table: "VariableType");
    }
}

拆分后可避免DDL与DML在同一事务中可能出现的执行顺序或锁机制问题。

3. 显式指定数据类型转换 #

若id_DescriptionType列数据类型与int存在差异（比如bigint），显式转换后再赋值：

migrationBuilder.Sql("UPDATE VariableType SET ExternalId = CAST(id_DescriptionType AS INT)");

4. 验证数据库权限 #

确认迁移执行的数据库账号拥有VariableType表的UPDATE权限，部分场景下迁移可能使用与手动执行不同的连接账号，导致权限不足。

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