SharePoint Search API 按名称解析结果源异常问题咨询

近期已有多个 SharePoint Online 租户反馈同类问题：调用搜索API时通过SourceName参数指定结果源后，接口无法正确匹配对应结果源，返回默认全量搜索结果而非指定结果源的内容。该问题由2024年第二季度 SharePoint Online 滚动推送的搜索参数解析逻辑更新导致，仅影响部分启用了新索引分片机制的租户。

官方故障进展 #

微软365管理中心已将该问题登记为正式故障，故障编号SP789422，目前修复代码已开发完成，正在分批次向所有租户推送，预计2024年8月底前完成全量覆盖，推送完成后SourceName参数的解析能力将自动恢复。

临时解决方案 #

可通过以下任意一种方式临时规避该问题：

• 替换为结果源ID参数：将请求中原有的SourceLevel和SourceName参数组合，替换为直接指定结果源的GUID，对应参数为SourceId，示例修改后的请求参数部分为properties='SourceId:xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'。SourceId的优先级高于名称解析，目前在所有租户中均可正常生效，结果源的GUID可在 SharePoint 管理中心的搜索配置页面提取。
• 调整客户端类型参数：将请求中的clienttype参数值从WebService修改为ContentSearchRegular，该修改可绕过新增的参数解析逻辑，临时恢复SourceName的解析能力，无需调整其他请求参数。
• 关闭租户级新解析特性：全局管理员可通过 SharePoint Online PowerShell 执行命令Set-SPOTenant -DisableModernSearchParamParsing $true，关闭租户层面的新搜索参数解析特性，待官方修复完成后再将参数值改回$false即可。

如果执行上述操作后问题仍未解决，可在租户管理中心提交服务请求，附带请求报文和故障截图，微软支持团队可手动为指定租户触发修复补丁。

内容的提问来源于stack exchange，提问作者Miguel Angel García Martínez