使用Entity Framework能否直接填充含自身列表的递归实体？

遇到的错误信息：

System.InvalidOperationException: Cycle detected while auto-including navigations: 'SimpleTask.Subtasks'. To fix this issue, either don't configure at least one navigation in the cycle as auto included in OnModelCreating or call 'IgnoreAutoInclude' method on the query.

实体类代码 #

public class SimpleTask 
{
    [Required]
    public int Id { get; set; }

    public int? fatherTaskId { get; set; }

    public ICollection<SimpleTask> Subtasks{ get; set; } = new List<SimpleTask>();
}

上下文类代码 #

public class DataContext : IdentityDbContext
{
    public DataContext(DbContextOptions<DataContext> options) : base(options) { }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        base.OnModelCreating(modelBuilder);

        modelBuilder.Entity<SimpleTask>()
                    .Navigation(t => t.Subtasks)
                    .AutoInclude();
    }

    public DbSet<SimpleTask> SimpleTasks { get; set; }
}

我的疑问：能否通过查询单个任务，结合AutoInclude()来递归填充它？原本以为问题出在生成SimpleTask的FatherTask对象，但问题仍然存在，请问哪里操作有误？

问题原因与解决办法 #

错误根源 #

你给Subtasks导航属性设置了全局AutoInclude()，但递归结构下，EF尝试自动包含子任务时，子任务又会触发自身的Subtasks自动包含，形成无限循环，触发了EF的循环检测机制，所以抛出了错误。

解决步骤 #

1. 移除全局AutoInclude配置
   先删掉OnModelCreating里的Navigation(t => t.Subtasks).AutoInclude()，避免全局自动包含导致循环。

2. 完善父子关系配置（可选但推荐）
   在OnModelCreating里明确配置父子任务的关联关系，让EF更清晰识别递归结构：

   modelBuilder.Entity<SimpleTask>()
       .HasMany(t => t.Subtasks)
       .WithOne()
       .HasForeignKey(t => t.fatherTaskId)
       .OnDelete(DeleteBehavior.Restrict); // 防止删除父任务时级联删除所有子任务
   

3. 实现递归填充的两种方式

   • 方式一：手动指定递归深度（适合深度固定的场景）
     在查询时通过嵌套Include和ThenInclude指定需要递归的层级：

     var targetTaskId = 1;
     var taskWithSubtasks = await context.SimpleTasks
         .Include(t => t.Subtasks)
             .ThenInclude(st => st.Subtasks)
                 .ThenInclude(sst => sst.Subtasks) // 这里可以继续嵌套增加深度
         .FirstOrDefaultAsync(t => t.Id == targetTaskId);
     

   • 方式二：用递归CTE实现无限深度填充（适合任意深度场景）
     通过SQL递归CTE查询所有关联任务，再手动组装成树结构：

     var targetTaskId = 1;
     // 用CTE查询所有关联的任务（根任务+所有子任务）
     var flatTasks = await context.SimpleTasks
         .FromSqlRaw(@"
             WITH RecursiveTasks AS (
                 SELECT * FROM SimpleTasks WHERE Id = {0}
                 UNION ALL
                 SELECT st.* FROM SimpleTasks st
                 INNER JOIN RecursiveTasks rt ON st.fatherTaskId = rt.Id
             )
             SELECT * FROM RecursiveTasks
         ", targetTaskId)
         .ToListAsync();
     
     // 手动构建任务树
     var taskDict = flatTasks.ToDictionary(t => t.Id);
     foreach (var task in flatTasks)
     {
         if (task.fatherTaskId.HasValue && taskDict.ContainsKey(task.fatherTaskId.Value))
         {
             taskDict[task.fatherTaskId.Value].Subtasks.Add(task);
         }
     }
     var rootTask = taskDict[targetTaskId];
     

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