EF Core SQLite错误19：已配置一对多关系仍触发FOREIGN KEY约束失败

问题原因 #

你遇到的SQLite外键约束报错，核心原因是ReportCard和CourseGrade的一对多关系没有配置级联删除，且默认删除策略为限制模式：

1. 你的ReportCard实体定义了ICollection<CourseGrade> Grades导航属性，但CourseGrade实体中没有显式声明关联ReportCard的外键，也没有反向导航属性。
2. EF Core会自动为CourseGrade生成隐式的ReportCardId外键字段，默认删除策略为Restrict：只要存在关联的CourseGrade记录，就不允许删除对应的ReportCard，触发外键约束报错。
3. 你之前配置的Student到ReportCard的级联删除，仅生效于删除Student时同步删除关联的ReportCard，和本次删除ReportCard的报错无关。

解决方案 #

方案1：配置级联删除（推荐）

在OnModelCreating方法中补充ReportCard和CourseGrade的关系配置，开启级联删除，删除ReportCard时自动删除关联的所有CourseGrade记录：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 原有Student和ReportCard的关系配置保留
    modelBuilder.Entity<Student>()
                .HasMany(s => s.ReportCards)
                .WithOne(r => r.Student)
                .OnDelete(DeleteBehavior.Cascade);
    
    // 新增ReportCard和CourseGrade的关系配置
    modelBuilder.Entity<ReportCard>()
                .HasMany(r => r.Grades)
                .WithOne() // CourseGrade没有反向导航到ReportCard的属性，此处留空
                .OnDelete(DeleteBehavior.Cascade);
}

配置完成后需要生成新的EF Core迁移，并更新数据库，让外键删除策略生效。

方案2：手动删除关联数据

如果你不需要级联删除，希望自行控制关联数据的处理，可以修改删除接口，先加载并删除关联的CourseGrade，再删除ReportCard：

[HttpDelete("{id}")]
public async Task<IActionResult> DeleteReportCard(long id)
{
    // 加载ReportCard时提前加载关联的Grades集合
    var reportCard = await _context.ReportCards
                                   .Include(r => r.Grades)
                                   .FirstOrDefaultAsync(r => r.ReportCardId == id);
    if (reportCard == null)
    {
        return NotFound();
    }

    // 先删除所有关联的CourseGrade
    _context.CourseGrades.RemoveRange(reportCard.Grades);
    // 再删除ReportCard
    _context.ReportCards.Remove(reportCard);
    await _context.SaveChangesAsync();

    return NoContent();
}

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