EF查询触发循环检测异常，求原因及解决方法

报错原因 #

你的CatalogPage实体是自引用层级结构：每个CatalogPage包含一个子CatalogPage集合（Pages导航属性），同时你在EF配置中开启了Pages的自动加载（AutoInclude）。

当执行查询时，EF会尝试自动加载每个CatalogPage的Pages属性：加载父页面后，会自动加载它的子页面集合；而每个子页面又会触发自动加载自己的Pages集合，以此类推形成无限递归循环。EF检测到这种循环后抛出该异常，防止无限加载导致的性能问题或内存溢出。

解决思路 #

有三种可行的解决方式，根据业务需求选择：

1. 全局取消自引用导航的自动加载
   如果你不需要全局自动加载Pages属性，在OnModelCreating中移除对Pages的AutoInclude配置：

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       // 移除这行自动加载配置：
       // modelBuilder.Entity<CatalogPage>().Navigation(x => x.Pages).AutoInclude();
   }
   

   后续需要加载子页面时，可在查询中手动使用Include(x => x.Pages)按需加载。

2. 局部查询时忽略自动加载
   若要保留全局自动加载，但当前查询不需要加载Pages，可在查询链中调用IgnoreAutoInclude()跳过所有自动加载的导航属性：

   var parentlessPages = await dbContext.Set<CatalogPage>()
       .IgnoreAutoInclude()
       .Where(x => x.CatalogPageId == -1)
       .ToListAsync();
   

   若当前查询需要加载其他自动配置的导航属性，可在IgnoreAutoInclude()后手动Include所需属性。

3. 限制自动加载的层级（EF Core 8+）
   如果你使用EF Core 8及以上版本，可以通过配置MaxDepth限制自动加载的递归层级，避免无限循环：

   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       modelBuilder.Entity<CatalogPage>()
           .Navigation(x => x.Pages)
           .AutoInclude()
           .MaxDepth(2); // 限制最多加载2层级的子页面
   }
   

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