C#使用AutoMapper映射含集合的表时触发EF Core拆分查询错误如何解决

报错原因 #

The query has been configured to use 'QuerySplittingBehavior.SplitQuery' and contains a collection in the 'Select' call, which could not be split into separate query. Please remove 'AsSplitQuery' if applied or add 'AsSingleQuery' to the query.

这个报错的根因是：

• 你的项目全局配置了 EF Core 5+ 新增的默认查询拆分行为 QuerySplittingBehavior.SplitQuery，该特性原本用于解决一对多关联查询产生的笛卡尔积爆炸问题
• 拆分查询存在明确限制：仅支持通过 Include 加载的关联集合拆分，不支持投影（Select 操作）中嵌套的集合拆分
• 你使用 AutoMapper 的 ProjectTo 方法做实体到 Dto 的映射时，本质是自动生成了包含 Operations 集合投影的 Select 语句，和全局的拆分查询配置冲突，因此触发报错
• 额外说明：你代码中写的 Include(p => p.Operations) 是多余的，ProjectTo 会自动根据 Dto 的属性结构加载需要的关联数据，无需手动加 Include

解决方案 #

你可以根据业务场景选择以下任意一种方案解决：

方案1：当前查询强制使用单查询模式（最快捷） #

直接在查询末尾追加 AsSingleQuery() 方法，覆盖全局的拆分查询配置，代码修改如下：

List<MainDto> All()
{
    var result = _mainTableRepository
       .ProjectTo<MainDto>(ObjectMapper.GetMapper().ConfigurationProvider)
       .AsSingleQuery()
       .ToList();
    return result;
}

方案2：调整全局拆分查询配置 #

如果你的项目大部分查询不需要拆分，可找到 DbContext 配置的位置，删除 UseQuerySplittingBehavior(QuerySplittingBehavior.SplitQuery) 配置，恢复默认单查询模式，仅在需要拆分的单个查询上手动加 AsSplitQuery() 即可。

方案3：手动拆分查询（适合大数据量场景） #

如果主表和关联表数据量很大，单查询笛卡尔积性能太差，可以分两次查询手动组装 Dto，避免触发投影嵌套集合的限制：

// 需先注入OperationTable对应的仓储
IRepository<OperationTable, int> _operationTableRepository;

List<MainDto> All()
{
    // 先查主表数据
    var mainList = _mainTableRepository.ToList();
    var mainIds = mainList.Select(x => x.Id).ToList();
    // 再查关联的操作表数据
    var operationList = _operationTableRepository.Where(x => mainIds.Contains(x.MainTableId)).ToList();
    // 手动组装Dto
    var result = ObjectMapper.Map<List<MainTable>, List<MainDto>>(mainList);
    foreach (var mainDto in result)
    {
        mainDto.Operations = ObjectMapper.Map<List<OperationTable>, List<OperationDto>>(
            operationList.Where(x => x.MainTableId == mainDto.Id).ToList()
        );
    }
    return result;
}

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