ASP.NET Core 5 使用EF查询分组导航菜单报InvalidOperationException异常

异常触发核心原因 #

抛出的InvalidOperationException是EF Core 3.0及以上版本的严格翻译校验触发的典型问题，核心诱因如下：

• 前置的分类查询使用Distinct操作去重后，直接嵌套返回集合属性的子查询，父查询未携带EF Core关联所需的全部表键列，数据库端无法生成合法的关联SQL
• 子菜单查询中添加了完全冗余的GroupBy操作，聚合操作会进一步丢失键列信息，触发“集合子查询无法翻译”的校验失败
• 在投影链中直接嵌套多层集合子查询，叠加Distinct/GroupBy操作时，EF Core会判定无法在无键实体上完成关联，直接抛出异常

注：该查询在LINQPad可运行，是因为LINQPad默认开启了宽松的客户端评估开关，Web应用中的EF Core默认配置会关闭隐式客户端评估，遇到无法翻译的操作直接抛出异常。

修复实现方案 #

将原本嵌套在投影链中的多层子查询拆分为独立的数据库查询步骤，在内存中完成层级组装，完全避开EF Core的翻译限制：

// 1. 先拉取所有主菜单对应的分类信息，完成内存端去重
var categoriasMenu = await _unitOfWork.Menu.GetAllQueryable()
    .Where(c => c.MenuPadreId == 0)
    .Select(c => new {
        c.MenuCategoriaId,
        CategoriaDescripcion = c.MenuCategoria.Descripcion
    })
    .Distinct()
    .ToListAsync();

// 2. 一次性拉取所有主菜单数据，数据库端直接关联子菜单明细与计数
var menusPrincipales = await _unitOfWork.Menu.GetAllQueryable()
    .Where(m => m.MenuPadreId == 0)
    .Select(m => new {
        // 携带分类ID用于内存过滤，不映射到ViewModel属性
        m.MenuCategoriaId,
        MenuItem = new MenuNavegacionViewModel {
            MenuId = m.MenuId,
            MenuPadreId = m.MenuPadreId,
            Descripcion = m.Descripcion,
            Area = m.Area,
            Controlador = m.Controlador,
            Accion = m.Accion,
            TieneUrl = m.TieneUrl,
            Icono = m.Icono,
            // 数据库端直接统计子菜单总数
            CountSubMenu = _unitOfWork.Menu.GetAllQueryable()
                .Count(me => me.MenuPadreId == m.MenuId),
            // 数据库端直接拉取当前主菜单下的子菜单，移除冗余的GroupBy操作
            MenuNavegacionSubViewModel = _unitOfWork.Menu.GetAllQueryable()
                .Where(s => s.MenuPadreId == m.MenuId && s.MenuPadreId > 0)
                .OrderBy(s => s.Descripcion)
                .Select(s => new MenuNavegacionSubViewModel {
                    MenuId = s.MenuId,
                    MenuPadreId = s.MenuPadreId,
                    Descripcion = s.Descripcion,
                    Area = s.Area,
                    Controlador = s.Controlador,
                    Accion = s.Accion,
                    TieneUrl = s.TieneUrl,
                    Icono = s.Icono
                })
                .ToList()
        }
    })
    .OrderBy(x => x.MenuItem.Descripcion)
    .ToListAsync();

// 3. 内存端完成「分类 > 主菜单 > 子菜单」的层级组装
var menuNavegacion = categoriasMenu
    .Select(cat => new MenuNavegacionCategoriaViewModel {
        CategoriaId = cat.MenuCategoriaId,
        Categoria = cat.CategoriaDescripcion,
        MenuNavegacionViewModel = menusPrincipales
            .Where(x => x.MenuCategoriaId == cat.MenuCategoriaId)
            .Select(x => x.MenuItem)
            .ToList()
    })
    .ToList();

注意事项 #

• 原有查询中对子菜单的GroupBy操作完全冗余：子菜单以MenuId为主键天然无重复，分组无实际业务价值，反而会触发翻译校验
• 拆分后的查询可以直接对接全局缓存，菜单这类低频变更的静态数据缓存后，可大幅降低数据库访问压力
• 不要在带Distinct/GroupBy的查询结果中直接嵌套返回集合的子查询，这是EF Core中触发该类异常的最高发场景

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