.NET 6+EF Core 6+SQLite报FOREIGN KEY约束失败错误原因排查

核心错误是SQLite Error 19: 'FOREIGN KEY constraint failed'，触发于database.SaveChanges()执行时，说明EF Core尝试写入的数据违反了SQLite的外键约束规则。你删除数据库、迁移文件夹或恢复备份的操作未解决问题，根源在于数据本身或代码的实体操作逻辑，具体原因包括：

• 关联实体不存在：新增或更新的实体，其外键字段指向的父实体在数据库中无对应记录。比如新增Order时设置CustomerId=5，但数据库里没有ID为5的Customer。
• 级联操作未正确处理：删除父实体时，关联的子实体未被同步处理（比如EF Core配置的级联删除未生效，或SQLite外键约束的级联规则和代码配置不一致）。比如删除Product后，关联的OrderItem仍保留该Product的ID，触发约束。
• 外键字段值违规：外键被配置为非空，但你给字段赋值了NULL，或未赋值（实体默认值为NULL），而关联的主键不会存在NULL值，导致约束失败。
• 备份数据本身有问题：恢复的备份数据中，部分子实体的外键指向的父实体不存在，备份数据本身就存在外键关联断裂的情况。
• EF Core实体配置不匹配：实体类的外键配置（Fluent API或Data Annotation）和数据库实际的外键约束不一致。比如代码里把外键设为可选，但数据库中该字段是NOT NULL且带外键约束；或者导航属性配置错误，导致EF Core生成的SQL不符合约束要求。

排查建议 #

• 在SaveChanges()前，输出待保存实体的状态和外键值，定位哪个实体的外键存在问题。
• 用SQLite工具（如SQLiteStudio）查看数据库表的外键约束，和EF Core的实体配置做对比，确认一致性。
• 恢复备份后直接在SQLite中执行查询，检查是否存在关联断裂的数据，例如：

  SELECT * FROM OrderItem WHERE ProductId NOT IN (SELECT Id FROM Product);
  

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