如何通过MS Graph下载SharePoint任务列表项的附件

核心问题分析 #

你尝试的/attachments端点本身是合规的，但报错大概率是以下原因导致：

• 目标任务列表未开启允许附件功能
• 应用权限配置不足或未完成授权
• 误用了不属于列表项资源段的/files端点

正确操作步骤 #

1. 开启列表附件功能 #

进入SharePoint站点的目标任务列表，打开「列表设置」→「高级设置」，找到「附件」选项，确认设置为「允许项目有附件」。

2. 配置合规权限 #

跨用户场景优先使用应用权限（无需用户上下文），需配置以下权限之一：

• Sites.Read.All（只读权限）
• Sites.ReadWrite.All（读写权限）
  确保权限已在Azure AD应用中添加，且完成了管理员授权（应用权限需要全局管理员同意）。

3. 获取附件的正确请求 #

使用v1.0版本API的标准端点：

GET https://graph.microsoft.com/v1.0/sites/{site_id}/lists/{list_id}/items/{list_item_id}/attachments

响应结果中，每个附件对象会包含@microsoft.graph.downloadUrl字段，直接用该URL即可下载对应文件，无需额外调用其他接口。

4. 备选：Beta版本端点测试 #

如果v1.0版本仍返回资源不存在错误，可临时切换到Beta版本端点排查：

GET https://graph.microsoft.com/beta/sites/{site_id}/lists/{list_id}/items/{list_item_id}/attachments

注意：Beta版本API存在变动风险，生产环境优先使用v1.0。

重要说明 #

SharePoint列表项的附件不会存储在站点驱动器的可见文件夹中，只能通过列表项的attachments端点获取，这是你在驱动器中找不到文件的原因。

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