使用siteId/listId/uniqueId查询SharePoint文件时Graph API返回404

1. 元数据正确但返回404的原因 #

• 页面元数据未同步：SharePoint页面的canvasLayout元数据可能是静态缓存的，当文件被移动、删除或转移到其他站点/列表后，页面引用未及时更新，导致提取的uniqueId/listId/siteId指向的位置已无目标文件。
• 权限限制：你的账号或应用对目标文件所在的列表/站点没有读取权限，Graph API会返回404（而非403，这是SharePoint权限模型的常规设计）。
• ID类型不匹配：从data.properties提取的uniqueId可能是文件的DriveItem ID，而非列表项ID。用它作为items/${uniqueId}的参数时，会因ID类型不符导致404。
• 列表类型兼容性问题：若文件所在列表是文档库，直接通过lists/items端点访问可能存在兼容性问题，文档库更适配Drive相关端点。

2. 可靠获取文件详情的替代方案 #

方案一：直接通过DriveItem ID访问 #

如果确认uniqueId是DriveItem ID，可跳过列表项路径，直接调用：

GET https://graph.microsoft.com/v1.0/sites/${siteId}/drive/items/${uniqueId}?select=id,size,parentReference,name,webUrl,file,createdBy,folder

若文件在子站点文档库，调整为：

GET https://graph.microsoft.com/v1.0/sites/${siteId}/drives/${driveId}/items/${uniqueId}?select=id,size,parentReference,name,webUrl,file,createdBy,folder

方案二：从页面关联的DriveItem获取 #

SharePoint页面本身属于DriveItem，可先获取页面的DriveItem，再遍历关联文件：

GET https://graph.microsoft.com/v1.0/sites/${siteId}/pages/${pageId}/driveItem?expand=children&select=children(id,name,webUrl,size)

适用于文件直接上传到页面关联文档库的场景。

方案三：使用搜索API定位文件 #

通过文件名或其他元数据缩小范围搜索：

GET https://graph.microsoft.com/v1.0/search/query?q=${fileName}&queryTemplate='contentclass:STS_ListItem_DocumentLibrary'&select=id,name,webUrl,size,createdBy

方案四：直接从页面Canvas控件提取 #

页面的canvasLayout中，嵌入文件通常会直接包含webUrl字段，可从以下路径提取，无需额外调用API：

canvasLayout.verticalSections[0].columns[0].controls[0].data.webUrl

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