使用Microsoft Graph筛选用户时出现OData错误求助

问题 #

使用基于.NET 6.0的最新版Microsoft Graph库列出组织内用户时，只要对mail字段执行筛选操作就会触发错误。注释掉Filter语句后功能正常运行，请问该筛选语句失效的原因是什么？

代码实现 #

var users = _appClient.Users.GetAsync((config) =>
                {
                    config.QueryParameters.Filter = "endswith(mail,'@org.com')";
                    // 仅请求特定属性
                    config.QueryParameters.Select = new[]
                        { "displayName", "id", "mail", "jobTitle", "officeLocation", "userPrincipalName" };
                    // 最多获取25条结果
                    config.QueryParameters.Top = 25;
                    // 按显示名称排序
                    config.QueryParameters.Orderby = new[] { "displayName" };
                });

                return users;

错误信息 #

An unhandled exception has occurred while executing the request. Microsoft.Graph.Models.ODataErrors.ODataError: Exception of type 'Microsoft.Graph.Models.ODataErrors.ODataError' was thrown.

原因分析与解决方案 #

• 部分用户mail字段为空：组织内可能存在未配置邮箱的用户，mail字段为null时，endswith函数无法对空值执行操作，直接触发OData错误。
• 权限不足：应用可能仅拥有基础的用户读取权限，筛选操作需要更高权限校验（比如User.Read.All应用权限），导致请求被拒绝。
• OData筛选逻辑漏洞：若域名包含特殊字符，endswith的匹配逻辑可能出现异常；或者部分租户的mail字段存储格式与预期不符。

解决建议 #

1. 筛选时先排除mail为空的用户：

   config.QueryParameters.Filter = "mail ne null and endswith(mail,'@org.com')";
   

2. 检查应用注册权限，确保已授予User.Read.All应用权限并完成管理员同意。
3. 捕获并解析详细OData错误，定位具体问题：

   try
   {
       var users = await _appClient.Users.GetAsync(config =>
       {
           config.QueryParameters.Filter = "endswith(mail,'@org.com')";
           config.QueryParameters.Select = new[] { "displayName", "id", "mail" };
           config.QueryParameters.Top = 25;
           config.QueryParameters.Orderby = new[] { "displayName" };
       });
       return users;
   }
   catch (ODataError odataError)
   {
       // 查看具体错误码和描述
       Console.WriteLine($"错误代码：{odataError.Error.Code}，详情：{odataError.Error.Message}");
       throw;
   }
   

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