.NET 6.0中Range数据注解属性在EF Core迁移中不生效问题

核心原因 #

EF Core 6.0中，[Range]注解属于模型验证注解，而非数据库结构映射注解。默认情况下，EF Core只会将影响数据库结构的注解（比如[Key]、[MaxLength]、[Required]）转换为数据库约束，[Range]仅作用于.NET代码层面的模型验证（比如API接口参数校验、表单验证），不会自动同步到数据库。

解决办法 #

要让数值范围约束生效到数据库层面，有两种常用方式：

方式1：使用Fluent API配置（推荐）

在你的DbContext的OnModelCreating方法中，为对应字段配置范围约束，这样EF Core生成迁移时会自动添加数据库层面的检查约束：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Profile>()
        .Property(p => p.Age)
        .HasCheckConstraint("CK_Profile_Age", "[Age] BETWEEN 18 AND 80");

    modelBuilder.Entity<Profile>()
        .Property(p => p.MonthlyHours)
        .HasCheckConstraint("CK_Profile_MonthlyHours", "[MonthlyHours] BETWEEN 40 AND 160");
}

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

dotnet ef migrations add AddRangeConstraints
dotnet ef database update

方式2：手动修改迁移类

如果已经生成了初始迁移，可以直接在迁移的Up方法中添加检查约束：

protected override void Up(MigrationBuilder migrationBuilder)
{
    // 原有创建表代码...
    
    migrationBuilder.AddCheckConstraint(
        name: "CK_Profile_Age",
        table: "profiles",
        sql: "[Age] BETWEEN 18 AND 80");

    migrationBuilder.AddCheckConstraint(
        name: "CK_Profile_MonthlyHours",
        table: "profiles",
        sql: "[MonthlyHours] BETWEEN 40 AND 160");
}

然后执行dotnet ef database update应用修改。

额外说明 #

如果需要同时保留.NET层面的验证，确保在数据保存前触发模型验证：

• 在API控制器中检查ModelState.IsValid
• 在服务层中调用context.ValidateEntities()（需要EF Core 5.0+）

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