Entity Framework Core中SQLite范围数据注解失效问题排查

嘿，这个问题我碰到过好几次了——EF Core和SQLite在数据约束这块确实有几个容易踩的坑，咱们一步步来排查你可能的操作失误：

1. 混淆了「模型验证」和「数据库约束」 #

EF Core的[Range]注解默认只做内存中的模型验证（也就是在调用SaveChanges()前检查实体数据），但SQLite本身不会自动把这个注解转换成数据库层面的CHECK约束。如果你的代码绕开了模型验证（比如直接用原生SQL插入、或者没触发EF的验证逻辑），就会出现能插入超出范围值的情况。

2. 未正确配置约束规则 #

先检查你的模型配置是否正确：

情况A：使用数据注解 #

确保你给ExitSide字段加了正确的[Range]注解，比如你期望的范围是0-4：

public class Station
{
    // 注意替换成你实际需要的最小/最大值
    [Range(0, 4)]
    public int ExitSide { get; set; }

    // 其他字段...
}

情况B：使用Fluent API #

如果用Fluent API配置，要注意EF Core版本差异：

• EF Core 7及以上版本支持直接用HasRange：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<Station>()
          .Property(s => s.ExitSide)
          .HasRange(0, 4); // 对应你需要的范围
  }
  

• EF Core 7以下版本需要手动添加CHECK约束：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<Station>()
          .HasCheckConstraint("CK_Station_ExitSide", "ExitSide BETWEEN 0 AND 4");
  }
  

3. 未触发模型验证 #

即使加了注解，EF Core默认不会自动强制验证，你需要手动触发或者在DbContext中全局启用：

手动触发验证（单次操作） #

var newStation = new Station { ExitSide = 5 };
var validationResults = new List<ValidationResult>();
var isValid = Validator.TryValidateObject(
    newStation, 
    new ValidationContext(newStation), 
    validationResults, 
    validateAllProperties: true
);

if (!isValid)
{
    // 处理验证错误，比如抛出异常或返回错误信息
    throw new ValidationException(string.Join(", ", validationResults.Select(r => r.ErrorMessage)));
}

context.Stations.Add(newStation);
context.SaveChanges();

全局自动验证（重写SaveChanges） #

在你的DbContext中重写SaveChanges方法，确保所有新增/修改的实体都经过验证：

public override int SaveChanges(bool acceptAllChangesOnSuccess)
{
    ValidateEntities();
    return base.SaveChanges(acceptAllChangesOnSuccess);
}

public override Task<int> SaveChangesAsync(bool acceptAllChangesOnSuccess, CancellationToken cancellationToken = default)
{
    ValidateEntities();
    return base.SaveChangesAsync(acceptAllChangesOnSuccess, cancellationToken);
}

private void ValidateEntities()
{
    var entitiesToValidate = ChangeTracker.Entries()
        .Where(e => e.State is EntityState.Added or EntityState.Modified)
        .Select(e => e.Entity);

    foreach (var entity in entitiesToValidate)
    {
        var validationContext = new ValidationContext(entity);
        Validator.ValidateObject(entity, validationContext, validateAllProperties: true);
    }
}

4. 未更新数据库架构 #

如果你是后来才添加的约束规则，需要通过EF迁移更新数据库：

1. 生成迁移：Add-Migration AddExitSideRangeConstraint
2. 更新数据库：Update-Database

⚠️ 注意：SQLite对ALTER TABLE添加CHECK约束的支持有限，如果迁移失败，你可能需要手动执行SQL语句添加约束，或者重新生成数据库：

ALTER TABLE Stations ADD CONSTRAINT CK_Station_ExitSide CHECK (ExitSide BETWEEN 0 AND 4);

5. 绕开了EF Core的验证逻辑 #

如果你直接用原生SQL插入数据（比如context.Database.ExecuteSqlRaw("INSERT INTO Stations (ExitSide) VALUES (5)")），EF Core的模型验证不会生效，这时候必须依赖数据库层面的CHECK约束才能阻止非法数据。

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