Android（Java）使用Graph API上传文件至SharePoint文档库遇403错误

嘿，既然你已经在Graph Explorer里成功上传了文件，那核心请求逻辑是没问题的，403错误基本都和权限配置或者请求细节遗漏有关，我给你梳理几个关键排查点和解决办法：

一、先查应用权限配置 #

Graph Explorer会自动请求足够的测试权限，但你的Android应用注册时可能权限没配全：

• 去Azure门户的应用注册里，确认添加了Sites.ReadWrite.All（或者更细粒度的站点权限），注意区分Delegated权限（用户登录时使用）和Application权限（后台服务用），根据你的认证方式选对类型
• 如果用的是OAuth授权流，要确保用户登录时请求的权限范围包含这个权限——比如在MSAL的token请求里，要把Sites.ReadWrite.All加入到scope数组里

二、验证请求端点和路径 #

虽然你在Graph Explorer里改对了路径，但Android代码里可能有细微偏差：

• 确认上传的端点格式是正确的：/sites/{site-id}/drive/items/{folder-id}:/{your-excel-filename}:/content
• 检查站点ID、文件夹ID有没有拼写错误，文件名里的特殊字符（比如空格、中文）要做URL编码，避免路径解析出错

三、检查Token的权限范围 #

403最常见的原因就是拿到的token没有对应的操作权限：

• 把Android里获取到的token复制到jwt.ms解析，看scp字段里有没有Sites.ReadWrite.All（Delegated权限）或者Sites.ReadWrite.All在roles字段里（Application权限）
• 如果用MSAL获取token，确保scope数组正确：

private static final String[] SCOPES = {"https://graph.microsoft.com/Sites.ReadWrite.All"};

四、请求头和文件格式要正确 #

上传Excel时，请求头不能乱设置：

• 针对.xlsx文件，Content-Type要设为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet；如果是旧版.xls，用application/vnd.ms-excel
• 别漏了Authorization: Bearer {token}请求头，而且要确保token没过期（可以在解析时看exp字段）

五、调整你的上传代码示例 #

假设你的代码是基于MSAL和Graph SDK，这里给你修正后的核心片段：

public void uploadExcelToSharePoint(String siteId, String folderId, String excelFilePath) {
    // 先获取有效token（这里用静默获取，失败则触发交互登录）
    IAuthenticationResult authResult = acquireTokenSilently();
    if (authResult == null) {
        // 处理用户重新登录逻辑
        return;
    }

    // 构建Graph客户端
    GraphServiceClient graphClient = GraphServiceClient.builder()
            .authenticationProvider(request -> {
                request.addHeader("Authorization", "Bearer " + authResult.accessToken);
            })
            .buildClient();

    File excelFile = new File(excelFilePath);
    try (InputStream fileStream = new FileInputStream(excelFile)) {
        // 执行上传：替换为你的站点ID、文件夹ID和文件名
        graphClient.sites(siteId)
                .drive()
                .items(folderId)
                .itemWithPath(excelFile.getName())
                .content()
                .buildRequest()
                .put(fileStream);
        // 上传成功后的逻辑
    } catch (IOException | ClientException e) {
        e.printStackTrace();
        // 捕获403时，可以提示用户权限不足，或者尝试重新获取token
        if (e instanceof ClientException && ((ClientException) e).getResponseCode() == 403) {
            // 处理权限不足的逻辑，比如引导用户重新授权
        }
    }
}

最后一个排查点 #

如果你的应用是单租户，要确认SharePoint站点所在的租户和你注册应用的租户是同一个；另外也可以检查下目标文档库的本地权限，确保当前登录用户有上传文件的权限（毕竟Graph权限够了，站点本身的权限也可能限制）

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