EF Core迁移异常：可空属性对应非可空列，无法生成修正迁移

问题背景 #

我的OverAllStatus模型类定义如下：

[Column("OverallStatusID")]
[StringLength(50)]
public string? OverallStatusId { get; set; }

但ContextModelSnapshot中该列被标记为非可空：

b.Property<string>("OverallStatusId")
     .IsRequired()
     .HasMaxLength(50)
     .HasColumnType("nvarchar(50)")
     .HasColumnName("OverallStatusID");

该列并非主键，但创建迁移时生成的文件为空；手动移除快照里的IsRequired()后，重新生成的迁移反而会把列改回非可空。怀疑是列名导致EF Core将其识别为键，进而强制非可空。

原因分析 #

EF Core的主键约定会自动识别以下命名的属性为主键：

• 名为Id的属性
• 名为{实体名}Id的属性（不区分大小写）

你的实体类是OverAllStatus，属性名是OverallStatusId——EF在匹配约定时会忽略大小写，将OverallStatusId判定为OverAllStatusId（即{实体名}Id格式），因此误把它当成了主键。主键默认强制非可空，所以即使你在模型中把属性设为string?，EF依然会按照主键规则生成IsRequired()的配置。

解决方案 #

方案1：使用数据注解显式标记非主键

在属性上添加[NotKey]特性（需引用System.ComponentModel.DataAnnotations命名空间），明确告诉EF该属性不是主键：

[Column("OverallStatusID")]
[StringLength(50)]
[NotKey]
public string? OverallStatusId { get; set; }

方案2：使用Fluent API显式配置

在DbContext的OnModelCreating方法中，直接配置该属性的可空性，覆盖默认约定：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<OverAllStatus>()
        .Property(p => p.OverallStatusId)
        .IsRequired(false) // 显式设置为可空
        .HasMaxLength(50)
        .HasColumnName("OverallStatusID");
}

后续操作

完成上述配置后，重新生成迁移：

• Package Manager Console：Add-Migration FixOverallStatusIdNullable
• .NET CLI：dotnet ef migrations add FixOverallStatusIdNullable

生成的迁移文件会包含将OverallStatusID列修改为可空的语句，执行迁移即可完成数据库更新。

注意：不要手动修改ContextModelSnapshot文件，它是EF自动维护的模型快照，手动修改会被后续的迁移操作覆盖。

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