使用Microsoft Graph API上传SharePoint文档新版本时保留元数据

核心问题分析 #

你当前流程产生多版本或元数据丢失的原因是：

• 首次上传时分两次操作（传文件→更新元数据），触发两次版本生成
• 更新文件时错误通过ListItem.DriveItem.Content路径操作，导致元数据被文件内置属性覆盖

以下是针对不同场景的最优解决方案：

场景1：首次上传文档并同步设置元数据（避免双版本） #

直接构造包含文件内容和元数据的DriveItem对象，通过单次PUT请求完成操作，仅生成1个版本。

// 构造包含业务元数据的DriveItem对象
var driveItem = new DriveItem
{
    Name = uploadFileName,
    File = new File(),
    ListItem = new ListItem
    {
        Fields = new FieldValueSet
        {
            AdditionalData = new Dictionary<string, object>
            {
                { "DocStatus", "Draft" },
                { "DocType", "TechnicalManual" },
                { "DocFormat", "docx" }
                // 按需添加其他自定义列
            }
        }
    },
    AdditionalData = new Dictionary<string, object>
    {
        // 指定冲突处理规则：若文件已存在则覆盖
        { "@microsoft.graph.conflictBehavior", "replace" }
    }
};

// 读取文件流（根据实际文件来源调整）
using var fileStream = new MemoryStream(fileBytes);

// 单次请求完成上传+元数据设置
var uploadResult = await _graphServiceClient
    .Sites[siteId]
    .Drives[driveId]
    .Root
    .ItemWithPath(uploadFileName)
    .Request()
    .PutAsync<DriveItem>(driveItem, fileStream);

场景2：更新现有文件内容且保留原元数据 #

直接对目标DriveItem的Content端点发起PUT请求，不触碰ListItem字段，仅替换文件内容，元数据完全保留，仅生成1个新版本。

// 直接更新文件内容，不修改任何元数据
await _graphServiceClient
    .Sites[siteId]
    .Drives[driveId]
    .Items[itemId]
    .Content
    .Request()
    .PutAsync<DriveItem>(file);

注意：避免使用原代码中.ListItem.DriveItem.Content的路径，该路径会触发文件内置属性同步到SharePoint列，导致业务元数据被覆盖。

场景3：更新文件内容同时修改元数据（单版本） #

如果需要在替换文件内容的同时调整元数据，同样通过单次PUT请求完成，仅生成1个版本：

var driveItem = new DriveItem
{
    ListItem = new ListItem
    {
        Fields = new FieldValueSet
        {
            AdditionalData = new Dictionary<string, object>
            {
                { "DocStatus", "Approved" } // 仅修改需要更新的元数据字段
            }
        }
    },
    AdditionalData = new Dictionary<string, object>
    {
        { "@microsoft.graph.conflictBehavior", "replace" }
    }
};

using var newFileStream = new MemoryStream(newFileBytes);

var updateResult = await _graphServiceClient
    .Sites[siteId]
    .Drives[driveId]
    .Items[itemId]
    .Request()
    .PutAsync<DriveItem>(driveItem, newFileStream);

关键注意事项 #

• 若上传文件的内置属性（如docx的作者、标题）与SharePoint自定义列重名，SharePoint会优先使用你在ListItem.Fields中明确设置的值，避免内置属性覆盖业务元数据。
• 确保应用拥有Files.ReadWrite.All或Sites.ReadWrite.All的Graph API权限（根据业务范围调整）。

内容的提问来源于stack exchange，提问作者Marisa B.