EF使用Fluent API配置多级关联迁移报SQLite外键约束错误

你遇到的SQLite Error 19: 'FOREIGN KEY constraint failed'报错和MainArt表的结构配置、ToTable映射缺失没有直接关系，核心是SQLite的EF Core提供程序的迁移特殊机制：

EF Core 操作SQLite执行迁移时，会先执行PRAGMA foreign_keys = 0临时关闭外键约束，再执行所有表创建、数据更新操作，所有操作完成后重新开启外键约束，并执行全库外键一致性校验。只要库中存在任何不符合外键约束的脏数据，就会抛出这个错误，和报错时刚好执行到MainArt表创建步骤没有必然关联。

1. 库中存在历史脏数据（最高发） #

如果这不是你第一次对该数据库执行迁移，库中残留的历史测试数据大概率是问题根源：

• 旧Paper表中存在ColorTypeId取值在ColorType表无对应主键的记录
• 之前插入的种子数据关联Id配置错误
• 之前迁移失败残留了不完整的表结构和数据
  修复方式：
• 开发环境直接删除旧的SQLite数据库文件，重新执行迁移生成干净的库即可
• 生产环境可以在关闭外键检查的阶段，查询所有关联表数据，删除关联Id不匹配的孤立记录。

2. 迁移执行逻辑冲突 #

如果你在代码中同时调用了Database.EnsureCreated()和Database.Migrate()两个初始化方法，会触发这类冲突：

• EnsureCreated()会直接按当前模型创建全量表结构，但不会写入迁移历史记录，后续Migrate()执行时会重复创建外键、执行表结构变更，触发约束校验失败。
• 手动修改过自动生成的迁移文件，导致表创建顺序和实体依赖顺序（ColorType→Paper→MainArt）不一致，也会触发问题。
  修复方式：
• 数据库初始化二选一即可：不需要版本化迁移选EnsureCreated()，需要用迁移做版本管理就只保留Migrate()调用。
• 如果迁移文件已经被改乱，删除Migrations文件夹和旧数据库，重新执行Add-Migration生成干净的初始迁移即可。

3. Fluent API配置优化（非必错，建议调整） #

你当前写的关联配置本身没有语法错误，一对多关系的配置是正确的，EF Core默认会按实体名映射表名，不需要额外配置ToTable()。但有两个细节可以调整，避免隐式规则带来的不可预期问题：

• 不需要手动为Id属性配置IsRequired()，作为主键EF Core会自动将其设置为必填非空，该配置属于冗余配置。
• 建议显式指定外键的删除行为，避免不同数据库提供程序的默认删除行为差异导致问题。

修正后的配置代码如下：

MainArt实体配置 #

public void Configure(EntityTypeBuilder<MainArt> builder)
{
    builder.HasOne(p => p.Paper)
        .WithMany()
        .HasForeignKey(p => p.PaperId)
        .OnDelete(DeleteBehavior.Cascade); // 级联删除行为可按需调整为Restrict、SetNull等
}

Paper实体配置 #

public void Configure(EntityTypeBuilder<Paper> builder)
{
    builder.Property(p => p.Name).IsRequired().HasMaxLength(100);
    builder.Property(p => p.PaperPrice).IsRequired();
    builder.HasOne(p => p.ColorType)
        .WithMany()
        .HasForeignKey(p => p.ColorTypeId)
        .OnDelete(DeleteBehavior.Cascade);
}

配置生效检查 #

确认你在DbContext的OnModelCreating方法中正确应用了所有配置类，否则你写的Fluent API配置不会生效：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    base.OnModelCreating(modelBuilder);
    // 不要遗漏配置注册，按需替换成你的配置类命名
    modelBuilder.ApplyConfiguration(new MainArtConfig());
    modelBuilder.ApplyConfiguration(new PaperConfig());
}

打开本次生成的迁移文件，查看Up方法末尾的逻辑，一定会存在如下SQL语句：

PRAGMA foreign_keys = 1;
PRAGMA foreign_key_check;

报错就是执行foreign_key_check时抛出的，你可以在这行代码之前加调试断点，临时查询库中所有关联表的数据，找到关联Id不匹配的脏数据即可快速定位问题。

内容的提问来源于stack exchange，提问作者n'or