Compiling a query which loads related collections for more than one collection navigation, either via 'Include' or through projection, but no 'QuerySplittingBehavior' has been configured

Compiling a query which loads related collections for more than one collection navigation, either via 'Include' or through projection, but no 'QuerySplittingBehavior' has been configured. By default, Entity Framework will use 'QuerySplittingBehavior.SingleQuery', which can potentially result in slow query performance. See https://go.microsoft.com/fwlink/?linkid=2134277 for more information. To identify the query that's triggering this warning call 'ConfigureWarnings(w => w.Throw(RelationalEventId.MultipleCollectionIncludeWarning))'.

在使用 Entity Framework (EF) 时，当查询加载多个集合导航（collection navigation）时，如果未配置 QuerySplittingBehavior，默认情况下 EF 会使用 QuerySplittingBehavior.SingleQuery，这可能导致性能问题。以下是对该问题的详细解释和解决方案。

问题描述

当在查询中使用 Include 或投影（projection）加载多个集合导航时，如果未配置 QuerySplittingBehavior，EF 默认会使用 QuerySplittingBehavior.SingleQuery。这种行为会导致生成一个包含多个 LEFT JOIN 的 SQL 查询，这可能会导致性能问题，尤其是在处理大量数据时 。

问题表现

• 性能问题：由于生成的 SQL 查询可能包含多个 LEFT JOIN 和 ORDER BY，这会导致查询性能下降，尤其是在处理大量数据时 。
• 警告信息：EF 会生成警告信息，提示用户注意此行为，并建议检查相关查询 。

解决方案

1. 配置 QuerySplittingBehavior

可以通过配置 QuerySplittingBehavior 来控制查询行为。例如，可以设置为 QuerySplittingBehavior.SplitQuery，以将多个集合导航的加载拆分为多个独立的查询，从而提高性能 。

optionsBuilder.UseQuerySplittingBehavior(QuerySplittingBehavior.SplitQuery);

2. 使用 Load 方法加载导航属性

可以使用 Load 方法逐个加载导航属性，而不是使用 Include。这种方法可以避免生成复杂的 JOIN 查询，从而提高性能 。

var mainEntity = await context.MainEntities.FindAsync(id);
await context.Entry(mainEntity).Collection(e => e.RelatedEntities).LoadAsync();

3. 使用 AsNoTracking()

如果不需要跟踪实体的更改，可以使用 AsNoTracking() 来减少内存占用和性能开销 。

var result = await context.Entities
    .AsNoTracking()
    .Include(e => e.RelatedEntities)
    .ToListAsync();

4. 启用警告日志

可以通过配置 ConfigureWarnings 来启用警告日志，以便更容易识别和调试性能问题 。

optionsBuilder.ConfigureWarnings(b => b.Throw(RelationalEventId.MultipleCollectionIncludeWarning));

总结

在使用 Entity Framework 时，当查询加载多个集合导航时，应考虑配置 QuerySplittingBehavior、使用 Load 方法或启用警告日志，以避免性能问题。通过合理配置和优化查询，可以显著提高应用的性能和可维护性。