Entity Framework Core查询多对多映射实体时返回全部嵌套子项问题

这种情况在EF Core 2.0里挺常见的，主要分两种场景：要么是你查询时不小心触发了递归的Include/ThenInclude，要么是序列化的时候因为实体循环引用导致的“假递归”。我来一步步给你拆解解决方案：

一、先排查是不是查询本身加载了过多层级 #

EF Core 2.0的Include只会加载你明确指定的导航属性，不会自动递归——除非你用了ThenInclude链式调用到了反向导航属性。比如你如果写了：

queryResult = context
    .MapExerciseWorkout.AsNoTracking()
    .Include(i => i.Exercise)
        .ThenInclude(e => e.MapExerciseWorkouts) // 这里又加载回了连接实体
        .ThenInclude(m => m.Workout) // 接着又加载Workout，循环就开始了
    .FirstOrDefault(...);

这就会导致EF不断递归加载关联的实体。

解决办法： #

1. 只Include到你需要的层级：如果你只需要MapExerciseWorkout关联的Exercise和Workout，就停在一级Include：

queryResult = context
    .MapExerciseWorkout.AsNoTracking()
    .Include(i => i.Exercise)
    .Include(i => i.Workout)
    .FirstOrDefault(...); // 按需用First/FirstOrDefault/ToList等

这样只会加载连接实体本身，以及它直接关联的Exercise和Workout，不会再往回加载连接实体集合。

2. 用投影查询替代Include：如果你不需要完整的实体对象，只需要部分属性，直接用Select投影可以精准控制返回的数据，从根源避免不必要的导航加载：

var result = context
    .MapExerciseWorkout.AsNoTracking()
    .Select(m => new 
    {
        m.Id,
        ExerciseId = m.Exercise.Id,
        ExerciseName = m.Exercise.Name,
        WorkoutId = m.Workout.Id,
        WorkoutName = m.Workout.Name
        // 只选你实际需要的字段
    })
    .FirstOrDefault(...);

二、如果是序列化时出现递归层级（比如返回JSON到前端） #

有时候查询结果本身只加载了一级导航，但转成JSON后出现了无限层级——这大概率是因为实体之间有循环引用：比如Exercise里有ICollection<MapExerciseWorkout>，而MapExerciseWorkout又有Exercise引用，序列化器默认会跟着引用一直递归下去。

解决办法： #

1. 配置序列化器忽略循环引用：如果你用的是Newtonsoft.Json（ASP.NET Core 2.0默认用这个），在Startup的服务配置里加一行：

services.AddMvc()
    .AddJsonOptions(options =>
    {
        options.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;
    });

这样序列化器碰到循环引用时会自动跳过，不会继续生成嵌套层级。

2. 用DTO（数据传输对象）隔离实体：创建专门的DTO类，只暴露你需要的属性，完全避开循环引用：

// 定义DTO
public class MapExerciseWorkoutDto
{
    public int Id { get; set; }
    public ExerciseDto Exercise { get; set; }
    public WorkoutDto Workout { get; set; }
}

public class ExerciseDto
{
    public int Id { get; set; }
    public string Name { get; set; }
    // 不要加MapExerciseWorkouts集合，避免循环
}

public class WorkoutDto
{
    public int Id { get; set; }
    public string Name { get; set; }
    // 同样不要加MapExerciseWorkouts集合
}

// 查询时投影到DTO
var result = context
    .MapExerciseWorkout.AsNoTracking()
    .Select(m => new MapExerciseWorkoutDto
    {
        Id = m.Id,
        Exercise = new ExerciseDto { Id = m.Exercise.Id, Name = m.Exercise.Name },
        Workout = new WorkoutDto { Id = m.Workout.Id, Name = m.Workout.Name }
    })
    .FirstOrDefault(...);

额外提醒：EF Core 2.0多对多的配置要点 #

EF Core 2.0不支持隐式多对多，必须手动配置连接实体MapExerciseWorkout的一对多关系，确保配置正确才能避免意外的加载行为：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 设置连接实体的复合主键
    modelBuilder.Entity<MapExerciseWorkout>()
        .HasKey(m => new { m.ExerciseId, m.WorkoutId });

    // 配置与Exercise的一对多
    modelBuilder.Entity<MapExerciseWorkout>()
        .HasOne(m => m.Exercise)
        .WithMany(e => e.MapExerciseWorkouts)
        .HasForeignKey(m => m.ExerciseId);

    // 配置与Workout的一对多
    modelBuilder.Entity<MapExerciseWorkout>()
        .HasOne(m => m.Workout)
        .WithMany(w => w.MapExerciseWorkouts)
        .HasForeignKey(m => m.WorkoutId);
}

内容的提问来源于stack exchange，提问作者philipp-fx