ASP.NET Core 8 Web API上传文件至OneDrive报错：DriveRequestBuilder无Root定义

问题根源 #

1. SDK版本与API结构变更：你使用的是Microsoft Graph SDK v5.x，该版本的API结构与旧版本（如v4）差异较大，旧写法不再适用。
2. 废弃包冲突：Microsoft.Graph.Auth是已废弃的预览包，与v5版本的Microsoft Graph SDK不兼容，会导致API识别异常；同时单独引用Microsoft.Graph.Core会与v5 SDK内置的Core功能产生版本冲突。

解决方案 #

1. 清理并调整NuGet包引用 #

删除冲突的废弃包，保留兼容的核心包：

<PackageReference Include="Azure.Identity" Version="1.12.0" />
<PackageReference Include="Microsoft.Graph" Version="5.57.0" /> <!-- 可更新至最新稳定版 -->
<PackageReference Include="Microsoft.Identity.Client" Version="4.64.1" />
<PackageReference Include="Swashbuckle.AspNetCore" Version="6.4.0" />

• 移除Microsoft.Graph.Auth：v5 SDK已改用Azure.Identity处理认证
• 移除Microsoft.Graph.Core：v5版本的Microsoft.Graph已内置该功能，单独引用会引发冲突

2. 修正上传代码（适配v5 SDK） #

v5 SDK中获取OneDrive根目录并上传文件的正确写法有两种：

方式一：使用Root属性

public async Task UploadFileToOneDriveAsync(Stream fileStream, string userId, string folderName, string fileName)
{
    // 路径无需前置/，ItemWithPath会自动处理相对路径
    var uploadPath = string.IsNullOrEmpty(folderName) ? fileName : $"{folderName}/{fileName}";

    await _graphClient.Users[userId].Drive.Root
        .ItemWithPath(uploadPath)
        .Content
        .PutAsync(fileStream);
}

方式二：通过Root的ID（"root"）获取根目录

public async Task UploadFileToOneDriveAsync(Stream fileStream, string userId, string folderName, string fileName)
{
    var uploadPath = string.IsNullOrEmpty(folderName) ? fileName : $"{folderName}/{fileName}";

    await _graphClient.Users[userId].Drive.Items["root"]
        .ItemWithPath(uploadPath)
        .Content
        .PutAsync(fileStream);
}

注意：v5 SDK中PutAsync无需指定泛型DriveItem，方法会自动返回对应类型。

3. 验证GraphClient初始化配置 #

确保使用Azure.Identity正确初始化GraphServiceClient，示例：

var credential = new ClientSecretCredential(tenantId, clientId, clientSecret);
var graphClient = new GraphServiceClient(credential, new[] { "https://graph.microsoft.com/.default" });

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