使用Microsoft Graph SDK 4.x时KQL路径过滤失效问题求助

问题现象 #

使用Microsoft Graph SDK 4.x调用搜索API时，包含URL路径的KQL查询（如test path:"https://~~"）无法生效：

• 在Graph Explorer中测试时，响应的searchTerms仅包含["test"]，过滤逻辑正常
• 通过SDK调用时，响应的searchTerms变成["test", "https://~~\""]，路径被当成独立搜索词，过滤失效

其他KQL语法（如时间范围筛选、标题/作者匹配）均可正常使用。

原因分析 #

问题出在JSON序列化时的转义字符处理错误：
代码中手动给searchQuery里的路径双引号添加了转义（path:\"https://(url)\"），但使用JsonConvert.SerializeObject序列化时，会再次对反斜杠进行转义，导致最终发送给API的查询字符串变成test path:"https://(url)\"。Graph API无法识别这种格式，将末尾的\"视为查询词的一部分，从而错误地把路径拆成独立搜索项。

而Graph Explorer直接接收原始KQL字符串，不需要手动添加转义，因此能正确解析path过滤条件。

解决方案 #

方案1：移除手动转义，让序列化自动处理 #

直接使用原始KQL字符串，无需手动给双引号加反斜杠，JsonConvert会自动完成正确的转义：

// 正确的searchQuery写法，无需手动转义双引号
string searchQuery = "test path:\"https://(url)\"";

var request = JsonConvert.SerializeObject(new
{
    requests = new[]
    {
        new
        {
            entityTypes = new[] { "driveItem" },
            query = new
            {
                queryString = searchQuery
            },
            from = 0,
            size = 15,
            region = "KOR"
        }
    }
});

方案2：使用SDK强类型对象构建请求（推荐） #

避免手动序列化JSON，直接使用Graph SDK提供的强类型类构建请求，从根源上避免转义错误：

using Microsoft.Graph.Models;

// 构建搜索请求对象
var searchRequest = new SearchRequest
{
    EntityTypes = new List<EntityType> { EntityType.DriveItem },
    Query = new SearchQuery
    {
        QueryString = "test path:\"https://(url)\""
    },
    From = 0,
    Size = 15,
    Region = "KOR"
};

// 发送请求
var result = await graphClient.Search.Query.PostAsync(new SearchPostBody
{
    Requests = new List<SearchRequest> { searchRequest }
});

验证方法 #

序列化后可以打印输出request字符串，检查queryString的内容是否为：

"queryString": "test path:\"https://(url)\""

确保没有多余的转义字符（如\"变成\\"）。

内容的提问来源于stack exchange，提问作者손동진