.NET 7中EF Core迁移存储过程与表变更的冲突问题

重新执行迁移时出现报错，核心原因是迁移顺序与存储过程（SP）版本不匹配：

• 初始迁移执行阶段，Table1仅包含Column1，但此时执行的SP脚本已被修改为引用后续迁移才会添加的列（比如你提到的ColumnA或新增的Column2/Column3），导致SP引用了不存在的表字段，触发无效列错误。
• EF Core迁移严格按顺序执行，早期迁移不能依赖后续迁移才会创建的数据库对象。

1. 拆分迁移，保证阶段一致性 #

每个迁移仅对应当前阶段的表结构和SP版本，避免跨阶段依赖：

• 初始迁移：负责创建基础表（Table1仅含Column1）、用户定义表类型（UDTT）和对应版本的SP（仅操作Column1）。
• 新增列迁移：先添加Column2/Column3，再更新SP适配新表结构。

2. 修复现有迁移代码 #

初始迁移示例（InitialCreate） #

public partial class InitialCreate : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        // 创建初始Table1（仅含Column1）
        migrationBuilder.CreateTable(
            name: "Table1",
            columns: table => new
            {
                Column1 = table.Column<string>(type: "nvarchar(max)", nullable: false)
                // 如有主键请在此添加约束
            },
            constraints: table =>
            {
                // 主键约束示例：table.PrimaryKey("PK_Table1", x => x.Column1);
            });

        // 创建UDTT
        migrationBuilder.Sql(UserDefinedTableTypesUtility.CreateProductDataType());

        // 创建初始版本SP（仅操作Column1）
        migrationBuilder.Sql(StoredProcedures.CreateInitialBulkInjectionSP());
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DropTable("Table1");
        migrationBuilder.Sql("DROP PROCEDURE InsertBulkData");
        migrationBuilder.Sql("DROP TYPE ProductDataType");
    }
}

SP脚本管理类 #

public static class StoredProcedures
{
    // 初始版本SP：仅处理Column1
    public static string CreateInitialBulkInjectionSP()
    {
        return @"CREATE OR ALTER PROCEDURE InsertBulkData
                     @Data ProductDataType READONLY
                  AS
                  BEGIN
                      INSERT INTO Table1 ([Column1])
                          SELECT [Column1]
                          FROM @Data;
                  END";
    }

    // 新增列后的SP版本：支持Column2/Column3
    public static string CreateUpdatedBulkInjectionSP()
    {
        return @"CREATE OR ALTER PROCEDURE InsertBulkData
                     @Data ProductDataType READONLY
                  AS
                  BEGIN
                      INSERT INTO Table1 ([Column1], [Column2], [Column3])
                          SELECT [Column1], [Column2], [Column3]
                          FROM @Data;
                  END";
    }
}

新增列的迁移示例（AddColumnsToTable1） #

public partial class AddColumnsToTable1 : Migration
{
    protected override void Up(MigrationBuilder migrationBuilder)
    {
        // 添加Column2和Column3
        migrationBuilder.AddColumn<string>(
            name: "Column2",
            table: "Table1",
            type: "nvarchar(max)",
            nullable: true);

        migrationBuilder.AddColumn<int>(
            name: "Column3",
            table: "Table1",
            type: "int",
            nullable: false,
            defaultValue: 0);

        // 更新SP到适配新结构的版本
        migrationBuilder.Sql(StoredProcedures.CreateUpdatedBulkInjectionSP());
    }

    protected override void Down(MigrationBuilder migrationBuilder)
    {
        migrationBuilder.DropColumn("Column2", "Table1");
        migrationBuilder.DropColumn("Column3", "Table1");
        // 回滚SP到初始版本
        migrationBuilder.Sql(StoredProcedures.CreateInitialBulkInjectionSP());
    }
}

3. 高效管理的核心原则 #

• 不修改已执行的迁移：EF Core依赖迁移文件的哈希值和执行顺序跟踪状态，修改旧迁移会导致迁移历史混乱。
• 使用CREATE OR ALTER PROCEDURE：无需先删除旧SP，直接更新为当前版本，简化迁移中的SP操作。
• 原子化迁移：每个迁移只做一件事（如加列、改SP），便于回滚和排查问题。

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