ADF调用Graph API连接SharePoint报404错误，Postman可正常访问求助

1. 相对路径格式错误 #

ADF的REST数据集基础URL已经以/v1.0/结尾，如果相对路径开头再加/，会生成https://graph.microsoft.com/v1.0//xxx这种无效URL，导致请求失败。Postman里手动输入时可能自动处理了多余斜杠，但ADF不会。

• 修复：把相对路径开头的斜杠去掉，比如将/sites/{site-id}/lists/{list-id}/items改成sites/{site-id}/lists/{list-id}/items。

2. 链接服务权限范围不全 #

链接服务测试连接成功只代表能获取令牌，但不一定拥有访问SharePoint数据的权限。Graph API访问SharePoint站点/列表需要Sites.Read.All或Sites.ReadWrite.All权限，可能你没在链接服务的Scope里配置。

• 修复：打开REST链接服务的身份验证设置，在Scope字段添加https://graph.microsoft.com/Sites.Read.All（只读场景）或https://graph.microsoft.com/Sites.ReadWrite.All（读写场景），保存后重新测试链接服务。

3. 请求头缺失关键参数 #

部分Graph API端点（比如获取列表项）需要ConsistencyLevel: eventual请求头，Postman里可能手动加了，但ADF默认没配置。另外，确保Accept: application/json头部存在，避免返回非JSON格式数据导致解析失败。

• 修复：在REST数据集的「请求头」配置里添加这两个键值对：
  • Accept: application/json
  • ConsistencyLevel: eventual

4. 服务主体权限未完成管理员同意 #

即使在Azure AD给服务主体添加了Graph API权限，若未点击「授予管理员同意」，权限不会实际生效。链接服务测试仅验证令牌获取，不校验数据访问权限。

• 修复：登录Azure门户 → Azure AD → 应用注册 → 找到你的服务主体 → 「API权限」页面 → 点击「授予管理员同意」，等待1-2分钟后重新运行ADF活动。

5. 分页配置不匹配Graph API规则 #

Graph API返回分页数据，ADF默认的分页规则可能不识别@odata.nextLink格式的分页链接，导致请求中断。

• 修复：先临时关闭分页（数据集设置→分页→选择「无」），测试是否能正常获取数据；如果需要分页，再配置分页规则为「基于响应内容中的URL」，指定@odata.nextLink作为下一页链接的路径。

6. 网络/区域限制 #

ADF的集成运行时区域可能和SharePoint站点、Graph API的访问区域存在网络隔离，导致请求失败，但本地Postman不受影响。

• 修复：切换ADF的集成运行时到与SharePoint站点同区域；如果用自托管集成运行时，确保该运行时所在网络能正常访问https://graph.microsoft.com。

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