EF Core 6迁移后Sqlite单元测试出现CreateTableOperation循环依赖错误如何解决

问题排查方法 #

• 二分法缩小配置范围：注释掉OnModelCreating中一半的实体配置，重新运行单元测试，逐步缩小组件范围，最快可在几次运行后定位到触发循环依赖的2-3个关联实体。
• 启用EF Core详细日志：在单元测试的DbContext配置中添加EnableDetailedErrors()和EnableSensitiveDataLogging()，完整日志会输出建表操作的排序过程，直接展示存在循环依赖的实体表名。
• 优先检查双向一对一配置：EF Core 6的Sqlite提供程序对双向一对一、互为外键的配置容忍度极低，而SQL Server支持延迟创建约束，所以线上环境运行正常，仅单元测试报错。

解决方案 #

• 方案一（推荐）：调整实体外键配置，删除双向一对一的互为外键设置，仅保留一侧的外键属性，另一侧仅保留导航属性关联，从根源解决循环依赖问题。
• 方案二（临时兼容）：如果业务逻辑必须保留现有双向外键配置，可在单元测试的Sqlite配置中关闭外键约束校验，该配置仅可用于测试环境，禁止在生产环境使用，配置示例如下：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseSqlite("Data Source=:memory:", 
        sqliteOptions => sqliteOptions.SuppressForeignKeyConstraints());
}

• 方案三：升级EF Core版本到7.0及以上，微软已在后续版本修复了Sqlite提供程序建表时的拓扑排序逻辑Bug，不需要修改原有业务配置即可正常运行。

该问题属于EF Core 6的已知缺陷，仅在使用Sqlite提供程序且存在双向外键配置时触发，与业务层的增删改查逻辑无关。

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