使用KQL查询时Microsoft Graph API $search报‘:字符无效’语法错误

在ASP.NET Core 9应用中使用Microsoft.Graph SDK（v5.92.0）搜索用户邮件，简单单关键词搜索可正常运行，但按照官方文档指定的KQL格式字符串进行搜索时，请求失败。

调用GraphServiceClient的代码如下：

var searchString = "\"from:email@domain.com\""; // 示例失败搜索值

var graphMessages = await _graphServiceClient.Me.Messages
    .GetAsync(requestConfiguration =>
    {
        requestConfiguration.QueryParameters.Select = [ "id", "receivedDateTime", "subject", "from", "bodyPreview", "webLink" ];
        requestConfiguration.QueryParameters.Top = 5;
        requestConfiguration.QueryParameters.Search = searchString;
    });

问题表现 #

• 若searchString为"my-search-term"这类简单值，调用成功；
• 若searchString为"from:email@domain.com"这类KQL值，调用失败。

抛出Microsoft.Graph.Models.ODataErrors.ODataError异常，错误信息：

Syntax error: character ':' is not valid at position 4 in 'from:email@domain.com'.

已尝试的解决方法 #

• 添加ConsistencyLevel请求头（文档相关资源中提及的方案）；
• 使用HttpClient手动发送请求，原始URL为https://graph.microsoft.com/v1.0/me/messages?$search="from:email@domain.com"，仍收到相同语法错误；
• 尝试多种引号组合（如有无外层双引号、属性组合等），均出现相同或类似错误。

使用的包版本 #

• Microsoft.Graph: 5.92.0
• Microsoft.Identity.Web.GraphServiceClient: 3.14.1

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