使用ListItem和FieldValueSet为SharePoint文件添加元数据遇错求助

问题根源 #

从Graph API获取的ListItem.fields包含系统只读字段（比如id），虽然你没手动添加，但这些字段会被默认包含在FieldValueSet的附加数据中。当你直接用这个对象调用put或patch时，Graph API会拒绝包含只读字段的请求，从而触发报错。

解决方案 #

方案1：新建FieldValueSet实例，只传入需要更新的自定义字段 #

不要复用从API获取的fieldValueSet，而是创建全新实例，仅添加你要更新的元数据字段：

private addMetadataToFile(PlatformOidcUser platformOidcUser, ListItem file, String itemPath, Map<String, String> metaData) {
    // 新建FieldValueSet，仅包含需要更新的自定义字段
    FieldValueSet fieldValueSet = new FieldValueSet()
    metaData.each { data ->
        fieldValueSet.additionalDataManager().put(data.key, new JsonPrimitive(data.value))
    }

    graphServiceClient.groups(platformOidcUser.defaultGroupId)
            .drive()
            .root()
            .itemWithPath(itemPath)
            .listItem()
            .fields()
            .buildRequest()
            .patch(fieldValueSet) // 使用patch做部分更新，避免覆盖原有数据
}

方案2：清理原FieldValueSet中的系统只读字段 #

如果需要保留原有非只读字段，可手动移除系统字段后再提交：

private addMetadataToFile(PlatformOidcUser platformOidcUser, ListItem file, String itemPath, Map<String, String> metaData) {
    FieldValueSet fieldValueSet = file.fields
    // 移除常见的系统只读字段
    def systemReadOnlyFields = ["id", "createdDateTime", "lastModifiedDateTime", "createdBy", "lastModifiedBy"]
    systemReadOnlyFields.each { field ->
        fieldValueSet.additionalDataManager().remove(field)
    }
    // 添加要更新的元数据
    metaData.each { data ->
        fieldValueSet.additionalDataManager().put(data.key, new JsonPrimitive(data.value))
    }

    graphServiceClient.groups(platformOidcUser.defaultGroupId)
            .drive()
            .root()
            .itemWithPath(itemPath)
            .listItem()
            .fields()
            .buildRequest()
            .patch(fieldValueSet)
}

关键说明 #

• 优先使用patch：put会替换所有字段，容易误删原有数据；patch仅更新指定字段，更适合元数据更新场景。
• 严格控制请求体字段：Graph API的字段更新接口不接受只读系统字段，必须确保请求体中只包含可编辑的自定义字段或可修改的系统字段。

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