EF Core生成不必要迁移脚本求助：实体未变更却出现列注解修改

问题现象 #

未修改数据库实体和配置类的情况下，EF Core生成了如下不必要的迁移脚本：

migrationBuilder.AlterColumn<short>(name: "ReservationTypeId",table: "ReservationType",type: "smallint",nullable: false,oldClrType: typeof(short),oldType: "smallint").Annotation("Relational:ColumnOrder", 0);

对应的实体类：

[Table("ReservationType")]
public class ReservationType
{   
    [Key]
    [Column(Order = 0)]
    public short ReservationTypeId { get; set; }
    public string Name { get; set; }
}

配置类：

public class ReservationTypeConfiguration : IEntityTypeConfiguration<ReservationType>
{   
    public void Configure(EntityTypeBuilder<ReservationType> builder)
    {
        builder.Property(x => x.ReservationTypeId).ValueGeneratedNever();
    }
}

使用环境：.NET 6 + EF Core 6.0.13

原因分析 #

核心原因是EF Core的模型快照与当前实体模型的元数据不一致：

• 实体类上显式添加了[Column(Order = 0)]注解，但之前的迁移快照（YourDbContextModelSnapshot.cs）中，ReservationTypeId属性的配置没有包含Annotation("Relational:ColumnOrder", 0)这一项。
• EF Core生成迁移时，会对比当前模型和快照的元数据，发现缺失该注解，因此判定需要修改列的元数据，生成了AlterColumn的脚本。
• 单个主键的Column(Order = 0)属于冗余配置（主键默认列顺序就是0），但显式声明后会被EF Core纳入元数据对比范围。

解决方法 #

方法1：同步模型快照 #

1. 打开项目中的YourDbContextModelSnapshot.cs文件（通常在Migrations文件夹下）。
2. 找到ReservationType实体对应的属性配置部分，手动添加Annotation("Relational:ColumnOrder", 0)，示例如下：

builder.Property<short>("ReservationTypeId")
    .ValueGeneratedNever()
    .HasColumnType("smallint")
    .Annotation("Relational:ColumnOrder", 0);

3. 保存快照后，再次生成迁移时就不会再出现该不必要的修改。

方法2：移除冗余注解 #

因为单个主键的Column(Order = 0)是默认行为，无需显式声明：

• 删除实体类中ReservationTypeId属性上的[Column(Order = 0)]注解。
• 重新生成迁移，此时EF Core会检测到模型与快照一致，不会生成不必要的脚本。

方法3：删除不必要的迁移 #

如果已经生成了该迁移脚本，且确认不需要执行：

1. 删除刚生成的迁移文件（包括.cs和.Designer.cs文件）。
2. 确保模型快照与当前实体模型一致（可通过方法1或方法2调整）。

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