EF关联作者至图书表时SQLite外键约束失败问题排查

针对你在MVVM图书馆项目中遇到的Sqlite Error 19: FOREIGN KEY constraint failed错误，以下是具体排查方向：

1. 验证关联的作者实体是否真实存在 #

直接查看SQLite数据库中的Authors表，执行查询语句：

SELECT * FROM Authors WHERE Id = 1;

确认是否存在ID为1、名为"Author1"的记录——不要仅依赖代码中的上下文缓存，可能上下文未跟踪到该实体，或数据库中根本无此数据。

2. 检查实体关联逻辑是否正确 #

• 直接赋值外键的情况：确保NewBook.AuthorId的类型与Authors表主键类型完全匹配（比如都是int，无类型不匹配问题），且赋值的1确实对应数据库中存在的作者ID。
• 关联实体对象的情况：确保关联的Author对象被当前DbContext跟踪，或已附加到上下文：

  // 错误示例：使用未被上下文跟踪的新对象
  var author = new Author { Id = 1, Name = "Author1" };
  newBook.Author = author;
  
  // 正确做法1：从上下文查询已有实体
  var author = _dbContext.Authors.Find(1);
  if (author != null) newBook.Author = author;
  
  // 正确做法2：确认实体存在时，附加到上下文
  var author = new Author { Id = 1, Name = "Author1" };
  _dbContext.Attach(author);
  newBook.Author = author;
  

3. 检查DbContext的关系配置 #

确保在OnModelCreating中正确配置了图书与作者的外键关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Book>()
        .HasOne(b => b.Author)
        .WithMany(a => a.Books)
        .HasForeignKey(b => b.AuthorId)
        .OnDelete(DeleteBehavior.Restrict); // 避免级联删除引发的意外约束问题
}

同时确认SQLite连接字符串启用了外键约束（EF Core默认启用，可显式指定）：

optionsBuilder.UseSqlite("Data Source=Library.db;Foreign Keys=True");

4. 检查实体状态是否异常 #

保存变更前，查看所有实体的状态，确保关联的Author状态不是Added（除非你要新增作者）：

foreach (var entry in _dbContext.ChangeTracker.Entries())
{
    Console.WriteLine($"{entry.Entity.GetType().Name}: {entry.State}");
}

如果Author状态为Added，EF会尝试插入新作者记录，可能因主键重复触发约束，进而导致外键关联失败。

内容的提问来源于stack exchange，提问作者Fatih Uyanık