调用含$apply=groupby的OData接口报AggregationWrapper缺失错误

问题根源 #

1. 聚合功能未启用：$apply属于OData的聚合查询能力，AspNetCore OData默认不开启该功能，必须显式配置才能支持分组、聚合类查询。
2. 模型未注册聚合相关类型：AggregationWrapper是OData处理分组/聚合结果的内置包装类型，如果Edm模型没有包含该类型的定义，就会触发这个错误。
3. OData服务配置缺失聚合支持：配置终结点时没启用$apply相关的查询选项，导致框架无法识别聚合语法。
4. NuGet包版本不兼容：你的Microsoft.AspNetCore.OData v8.0.11和其他OData核心/客户端包7.12.2版本不匹配，版本差异可能导致类型加载异常。

排查修复步骤 #

• 检查Edm模型构建代码：
  给目标实体集启用聚合支持，示例代码：

  var modelBuilder = new ODataConventionModelBuilder();
  // 注册实体集
  var rainMitigationSet = modelBuilder.EntitySet<RainMitigation>("RainMitigation");
  // 启用该实体的聚合功能
  rainMitigationSet.EntityType.EnableAggregation();
  

• 验证OData终结点配置：
  在.NET 6的Program.cs中，确保启用$apply查询选项：

  app.UseEndpoints(endpoints =>
  {
      // 启用所需的OData查询选项，必须包含Apply()
      endpoints.Select().Filter().OrderBy().Count().MaxTop(100)
               .Expand().Apply();
      endpoints.MapODataRoute("odata", "odata", GetEdmModel());
  });
  

• 统一NuGet包版本：
  AspNetCore OData和OData核心包版本需要匹配，比如将Microsoft.AspNetCore.OData升级到8.2.x，对应OData核心/客户端包升级到7.17.x；或者保持AspNetCore OData 8.0.x，将其他OData包降级到7.10.x左右的兼容版本。版本不匹配很容易引发类型相关的异常。
• 验证查询语法与实体属性：
  确认MyColumnName是RainMitigation实体中存在的有效属性，没有拼写错误，也没有被[IgnoreDataMember]标记为忽略。可以先尝试带聚合函数的查询，比如：

  https://localhost:7181/odata/RainMitigation?$apply=groupby((MyColumnName), aggregate(Id with count as TotalCount))
  

  看是否能正常返回结果。

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