使用Graph API Java SDK为SharePoint文件加元数据：GET正常PUT/PATCH报错

以下是导致请求失败的核心问题及对应修复方案：

1. Groovy闭包语法错误，元数据未被正确添加 #

你的metaData.each循环多了一层冗余大括号，导致元数据键值对根本没被写入fieldValueSet，最终请求体为空，触发无效请求。

错误代码片段：

metaData.each {data -> {
    fieldValueSet.additionalDataManager().put(data.key, new JsonPrimitive(data.value))
}}

修复后：

metaData.each { data ->
    fieldValueSet.additionalDataManager().put(data.key, new JsonPrimitive(data.value))
}

2. 使用PUT请求而非PATCH请求 #

Microsoft Graph中，PUT请求要求替换整个字段资源，必须包含该列表项的所有必填字段，否则会返回无效请求。而增量更新元数据应该用PATCH请求，只传递需要修改的字段即可。

修改请求方法：
把put(fieldValueSet)替换为patch(fieldValueSet)：

graphServiceClient.groups(oidcUser.defaultGroupId)
        .drive()
        .items(itemId)
        .listItem()
        .fields()
        .buildRequest()
        .patch(fieldValueSet)

3. 确认字段名称为SharePoint内部名称 #

SharePoint字段的显示名称和内部名称可能不一致（比如自定义字段会自动添加后缀），如果用显示名称发起请求会失败。可以通过以下代码获取目标列表的所有字段，确认字段的internalName：

// 替换为你的站点ID和列表ID
def fields = graphServiceClient.sites("{site-id}")
        .lists("{list-id}")
        .fields()
        .buildRequest()
        .get()

确保你传入的DocumentType、User是字段的内部名称，而非显示名称。

4. 检查User字段的类型匹配 #

如果User字段是SharePoint的「用户/组」类型，直接传入ID字符串不符合格式要求，需要构造特定的JSON结构：

// 调用时修改User字段的传入格式
metaDataValues.put("User", oidcUser.userEntity.id)

// 在addMetadataToFile方法中针对User字段特殊处理
if (data.key == "User") {
    JsonObject userLookup = new JsonObject()
    userLookup.add("LookupId", new JsonPrimitive(data.value))
    fieldValueSet.additionalDataManager().put(data.key, userLookup)
} else {
    fieldValueSet.additionalDataManager().put(data.key, new JsonPrimitive(data.value))
}

修复后的完整方法代码 #

private addMetadataToFile(OidcUser oidcUser, String itemId, Map<String, String> metaData) {
    FieldValueSet fieldValueSet = new FieldValueSet()
    
    // 正确遍历并添加元数据，处理用户类型字段
    metaData.each { data ->
        if (data.key == "User") {
            JsonObject userLookup = new JsonObject()
            userLookup.add("LookupId", new JsonPrimitive(data.value))
            fieldValueSet.additionalDataManager().put(data.key, userLookup)
        } else {
            fieldValueSet.additionalDataManager().put(data.key, new JsonPrimitive(data.value))
        }
    }

    // 可选：调试用，验证列表项字段是否可正常获取
    FieldValueSet existingFields = graphServiceClient.groups(oidcUser.defaultGroupId)
            .drive()
            .items(itemId)
            .listItem()
            .fields()
            .buildRequest()
            .get()

    // 使用PATCH增量更新元数据
    graphServiceClient.groups(oidcUser.defaultGroupId)
            .drive()
            .items(itemId)
            .listItem()
            .fields()
            .buildRequest()
            .patch(fieldValueSet)
}

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