.NET 7中Entity Framework多对多关联引发无限循环问题排查

问题核心原因 #

你遇到的无限循环不是Json序列化阶段的问题，而是EF Core加载实体到内存后，实体间的双向导航属性形成了循环引用，导致遍历或处理内存中的对象时触发无限递归。ReferenceHandler.IgnoreCycles仅作用于Json序列化过程，对内存中实体对象的循环引用无效。

常见触发场景：

• 实体类配置了双向导航（比如Partenaire包含ActivityPartenaires，ActivityPartenaire又包含Partenaire，Activity包含ActivityPartenaires），EF Core跟踪实体时会自动填充反向导航属性，形成闭环。
• 投影构造实体对象时，不小心保留了双向引用关系，导致内存中对象互相引用。

解决方法 #

1. 使用AsNoTracking()禁用实体跟踪 #

如果不需要对查询结果进行修改保存，在查询中添加AsNoTracking()，EF Core不会自动填充反向导航属性，避免内存中的循环引用：

public IQueryable<Partenaire> GetAllAsQueryable()
{
    return _context.Partenaires
        .Include(p => p.ActivityPartenaires)
            .ThenInclude(ap => ap.Activity)
        .AsNoTracking(); // 禁用实体跟踪
}

2. 改用DTO投影，彻底切断循环引用 #

创建只包含业务所需字段的DTO类，投影时仅映射必要属性，从根源避免循环：

// 定义DTO类
public class PartenaireDto
{
    public Guid Id { get; set; }
    public string Nom { get; set; }
    public List<ActivityDto> Activities { get; set; } = new();
}

public class ActivityDto
{
    public Guid Id { get; set; }
    public string Libelle { get; set; }
}

// 查询并投影到DTO
public List<PartenaireDto> GetAllPartenairesWithActivities()
{
    return _context.Partenaires
        .Include(p => p.ActivityPartenaires)
            .ThenInclude(ap => ap.Activity)
        .Select(p => new PartenaireDto
        {
            Id = p.Id,
            Nom = p.Nom,
            Activities = p.ActivityPartenaires.Select(ap => new ActivityDto
            {
                Id = ap.Activity.Id,
                Libelle = ap.Activity.Libelle
            }).ToList()
        })
        .ToList();
}

3. 检查多对多关系配置是否正确 #

确保中间实体ActivityPartenaire的复合主键和导航属性配置无误，避免EF Core加载数据时出现异常循环：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置中间实体复合主键
    modelBuilder.Entity<ActivityPartenaire>()
        .HasKey(ap => new { ap.PartenaireId, ap.ActivityId });

    // 配置Partenaire与中间实体的关联
    modelBuilder.Entity<ActivityPartenaire>()
        .HasOne(ap => ap.Partenaire)
        .WithMany(p => p.ActivityPartenaires)
        .HasForeignKey(ap => ap.PartenaireId)
        .OnDelete(DeleteBehavior.Cascade);

    // 配置Activity与中间实体的关联
    modelBuilder.Entity<ActivityPartenaire>()
        .HasOne(ap => ap.Activity)
        .WithMany(a => a.ActivityPartenaires)
        .HasForeignKey(ap => ap.ActivityId)
        .OnDelete(DeleteBehavior.Restrict);
}

4. 投影时排除反向导航属性 #

如果一定要使用实体类投影，确保不包含会反向引用回Partenaire的属性：

.Select(p => new Partenaire
{
    Id = p.Id,
    Nom = p.Nom,
    // 仅映射Activity的基础字段，不包含反向导航属性
    Activities = p.ActivityPartenaires.Select(ap => new Activity
    {
        Id = ap.Activity.Id,
        Libelle = ap.Activity.Libelle
        // 不要包含 ActivityPartenaires 或 Partenaires 属性
    }).ToList()
})

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