使用SharePoint REST API可上传文件但无法获取文件列表的问题排查

核心问题排查点 #

1. 授权模式误用 #

你当前代码中使用grant_type=authorization_code，但该模式必须传入用户授权后的code参数，而你的代码里仅传入client_id、client_secret和scope，这本身不符合授权码模式的要求。虽然能拿到令牌，但该令牌的权限逻辑可能存在异常——推测平台返回了不符合预期的权限令牌，导致读取列表时鉴权失败。

如果是无用户交互的守护程序场景，应切换为client_credentials模式：

$token = json_decode($guzzle->post($url, [
    'form_params' => [
        'client_id' => '<<client ID>>',
        'client_secret' => '<<client secret>>',
        'scope' => "https://<<site>>.sharepoint.com/.default",
        'grant_type' => 'client_credentials', // 替换为守护程序模式
    ],
])->getBody()->getContents());

2. SharePoint应用权限配置缺失 #

上传文件与读取列表对应的权限逻辑不同，即使令牌中包含权限，也需确认：

• 在Azure AD应用注册中添加SharePoint Online应用权限：如Sites.Read.All或Sites.ReadWrite.All（按需选择），并完成管理员同意操作。
• 若为站点级权限，需通过SharePoint管理中心或PowerShell将应用权限绑定到目标站点：

  Connect-SPOService -Url https://yourtenant-admin.sharepoint.com
  Grant-SPOAppPermission -AppId "你的client ID" -PermissionScope "https://yourtenant.sharepoint.com/sites/yoursite/.default" -Site https://yourtenant.sharepoint.com/sites/yoursite
  

3. 请求头与站点URL校验 #

返回x-forms_based_auth_required头，说明目标站点可能启用了基于表单的认证，应用权限模式下可通过以下方式规避：

• 确认siteURL为正确的站点根URL（如https://xxx.sharepoint.com/sites/yoursite），避免路径错误触发表单登录重定向。
• 在请求头中补充Content-Type: application/json;odata=verbose，当前仅设置了Accept，部分场景需同时指定Content-Type。

4. 令牌受众验证 #

解析令牌时，确认aud（受众）字段是否匹配目标站点URL（https://<<site>>.sharepoint.com），若受众不符，SharePoint会直接拒绝请求。若使用租户级权限，受众应为https://sharepoint.com。

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