EntityFramework Core中高效获取关联实体列表的优化方法咨询

问题根源 #

你当前的代码仅查询了Recipe表本身，EF Core默认不会自动加载关联的导航属性（比如Ingredients、Steps、Author），导致这些字段返回null；而手动多次调用仓储查询关联数据，会引发N+1查询问题（查1条Recipe，额外触发3次关联表查询），处理多个Recipe时性能会急剧下降。

最优解决方案：预加载（Eager Loading）+ 导航属性配置 #

第一步：补全实体类的导航属性 #

首先要在实体类中定义关联关系的导航属性，让EF Core能识别并加载关联数据：

// Recipe类
public class Recipe
{
    public int Id { get; set; }
    public string Name { get; set; }
    // 外键字段
    public string UserLogin { get; set; }
    
    // 关联作者的导航属性
    public User Author { get; set; }
    // 关联食材集合的导航属性
    public ICollection<Ingredient> Ingredients { get; set; } = new List<Ingredient>();
    // 关联步骤集合的导航属性
    public ICollection<Step> Steps { get; set; } = new List<Step>();
}

// Ingredient类
public class Ingredient
{
    public int Id { get; set; }
    public string Name { get; set; }
    // 关联Recipe的外键
    public int RecipeId { get; set; }
    
    public Recipe Recipe { get; set; }
}

// Step类
public class Step
{
    public int Id { get; set; }
    public string Description { get; set; }
    public int RecipeId { get; set; }
    
    public Recipe Recipe { get; set; }
}

// User类
public class User
{
    // 假设主键是Login字段
    public string Login { get; set; }
    public string Name { get; set; }
    
    public ICollection<Recipe> Recipes { get; set; } = new List<Recipe>();
}

第二步：修改仓储方法，用预加载一次性获取所有数据 #

修改GetRecipeById方法，使用Include和ThenInclude一次性加载所有关联数据，这样只会生成一条SQL查询，彻底解决N+1问题：

public Recipe GetRecipeById(int id)
{
    return _context.Recipes
        .Include(r => r.Author) // 加载关联的作者
        .Include(r => r.Ingredients) // 加载关联的食材集合
        .Include(r => r.Steps) // 加载关联的步骤集合
        .FirstOrDefault(r => r.Id == id);
}

第三步：简化DTO映射逻辑 #

因为关联数据已经通过预加载加载完成，现在直接用AutoMapper映射即可，不需要再单独查询：

RecipeReadDTO RetrieveRecipesInfos(Recipe recipe)
{
    if (recipe == null)
        return null;

    // AutoMapper会自动映射已加载的导航属性到DTO
    return _map.Map<RecipeReadDTO>(recipe);
}

进阶优化：直接投影到DTO（性能更优） #

如果不需要完整的Recipe实体，还可以直接通过投影查询到RecipeReadDTO，减少不必要的数据传输：

public RecipeReadDTO GetRecipeDtoById(int id)
{
    return _context.Recipes
        .Where(r => r.Id == id)
        .Select(r => new RecipeReadDTO
        {
            Id = r.Id,
            Name = r.Name,
            Author = new UserReadDTO
            {
                Login = r.Author.Login,
                Name = r.Author.Name
                // 按需添加其他字段
            },
            Ingredients = r.Ingredients.Select(i => new IngredientReadDTO
            {
                Id = i.Id,
                Name = i.Name
                // 按需添加其他字段
            }).ToList(),
            Steps = r.Steps.Select(s => new StepReadDTO
            {
                Id = s.Id,
                Description = s.Description
                // 按需添加其他字段
            }).ToList()
        })
        .FirstOrDefault();
}

这种方式会生成只包含DTO所需字段的SQL，避免加载实体的冗余属性，性能进一步提升。

补充：显式配置关联关系（可选） #

如果EF Core无法自动识别关联，可以在DbContext的OnModelCreating中用Fluent API显式配置：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    // 配置Recipe与User的关联
    modelBuilder.Entity<Recipe>()
        .HasOne(r => r.Author)
        .WithMany(u => u.Recipes)
        .HasForeignKey(r => r.UserLogin);
    
    // 配置Recipe与Ingredient的关联
    modelBuilder.Entity<Ingredient>()
        .HasOne(i => i.Recipe)
        .WithMany(r => r.Ingredients)
        .HasForeignKey(i => i.RecipeId);
    
    // 配置Recipe与Step的关联
    modelBuilder.Entity<Step>()
        .HasOne(s => s.Recipe)
        .WithMany(r => r.Steps)
        .HasForeignKey(s => s.RecipeId);
}

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