使用SQLite与EF Core保存同CategoryId的多个Item时触发外键约束错误

SQLite是否支持该场景？ #

完全支持。一个分类对应多个Item的一对多关联是关系型数据库的基础场景，SQLite对这种外键关联的支持是完整的，报错并非场景不被支持，而是你的代码或数据操作存在问题。

错误原因分析 #

出现SQLite Error 19: 'FOREIGN KEY constraint failed'通常有以下几种可能：

• 要保存的Item的CategoryId对应的Category记录不存在于数据库中
• 保存顺序有误：先保存了Item，再保存关联的Category（EF Core默认不会自动级联保存未被跟踪的关联实体）
• 模型配置存在疏漏：比如外键属性的约束逻辑不符合预期

解决方法 #

针对上述可能的问题，给出对应的解决步骤：

1. 确保关联分类已存在或自动级联保存 #

如果是创建新分类并添加Item，可通过EF Core的级联保存自动处理关联关系，无需手动设置外键：

var category = new Category { CategoryName = "电子产品" };
category.Items = new List<Item>
{
    new Item { ItemName = "手机" },
    new Item { ItemName = "笔记本电脑" }
};

using (var dbContext = new YourDbContext())
{
    dbContext.Categories.Add(category);
    dbContext.SaveChanges(); // EF Core会自动保存Category及关联Item，外键将自动赋值
}

2. 修正模型配置（优化项） #

你的现有模型可以简化，EF Core会根据约定自动识别外键，无需手动添加[ForeignKey]特性，建议补充导航属性让关联关系更清晰：

public class Item
{
    public int ItemId { get; set; }
    public string ItemName { get; set; }
    public int CategoryId { get; set; }
    // 添加导航属性，明确与Category的关联
    public Category Category { get; set; }
}

public class Category
{
    public int CategoryId { get; set; }
    public string CategoryName { get; set; }
    public List<Item>? Items { get; set; }
}

3. 调整保存顺序（手动关联场景） #

如果是分别创建Category和Item，需先保存Category获取有效ID，再设置Item的外键后保存：

using (var dbContext = new YourDbContext())
{
    var category = new Category { CategoryName = "服装" };
    dbContext.Categories.Add(category);
    dbContext.SaveChanges(); // 先保存分类，获取生成的CategoryId

    var item1 = new Item { ItemName = "T恤", CategoryId = category.CategoryId };
    var item2 = new Item { ItemName = "裤子", CategoryId = category.CategoryId };
    dbContext.Items.AddRange(item1, item2);
    dbContext.SaveChanges(); // 再保存Item
}

4. 确认外键约束启用 #

确保DbContext配置中启用了SQLite外键约束（默认已启用，可显式确认）：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseSqlite("Data Source=yourdatabase.db")
                  .UseSqlite(builder => builder.UseForeignKeys());
}

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