Azure Cognitive Search SharePoint索引器：元数据调用SharePoint API失败

核心问题：元数据字段对应错误 #

你用的metadata_spo_site_library_item_id是SharePoint文件的UniqueId（GUID格式的唯一标识符），不是列表项的整数Id字段。你之前的请求用Id eq '{metadata_spo_site_library_item_id}'做过滤，相当于用GUID去匹配整数ID，自然找不到对应文档。

正确的API调用方式 #

1. 直接通过UniqueId获取文件 #

用这个端点能直接定位到文件，返回完整的文件属性：

GET https://<你的租户域名>.sharepoint.com/sites/<你的站点名>/_api/web/GetFileById('{metadata_spo_site_library_item_id}')
Accept: application/json;odata=nometadata

2. 通过文档库列表项过滤 #

如果要从列表维度查询，需要用UniqueId字段做过滤，而不是Id：

GET https://<你的租户域名>.sharepoint.com/sites/<你的站点名>/_api/web/lists/GetByTitle('<文档库名称>')/items?$select=*,File&$filter=UniqueId eq '{metadata_spo_site_library_item_id}'

3. 结合其他元数据精准定位 #

如果ACS返回了metadata_spo_site_id和metadata_spo_library_id，可以用这些ID直接定位站点和库，避免依赖文档库名称（名称可能变更）：

GET https://<你的租户域名>.sharepoint.com/sites/<你的站点名>/_api/web/Sites('{metadata_spo_site_id}')/Lists('{metadata_spo_library_id}')/Items?$select=*,File&$filter=UniqueId eq '{metadata_spo_site_library_item_id}'

额外排查点 #

• 权限验证：确保调用API的身份（应用权限/用户权限）拥有目标文档库的读取权限，否则会返回403或空结果。
• GUID格式：确保metadata_spo_site_library_item_id的格式完整，保留连字符，不要额外编码或截断。

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