C# Graph API SDK V5添加单个用户至多个组失败的问题排查

我有一个用于创建和管理用户的小工具（本地Active Directory → 同步至Azure AD），原本可将用户分配到多个本地及云端组，在Graph API SDK < V5版本中运行正常，代码如下：

var directoryObject = new DirectoryObject
{
    Id = userid
};
try
{
    foreach (String i in groupids)
    {
        await graphClient.Groups[i].Members.References
        .Request()
        .AddAsync(directoryObject);
    }
}

升级到Graph API SDK V5后，其他功能均正常，仅该步骤出现问题。我尝试用以下代码实现：

var requestbody = new ReferenceCreate
{
    OdataId = graphClient.DirectoryObjects[userid].ToGetRequestInformation().URI.ToString(),
};
foreach (String i in groupids)
{
await graphClient.Groups[i].Members.Ref.PostAsync(requestbody);
}

此代码仅能成功添加用户到一个组，添加第二个组时会报错：

an unexpected 'end of input' node was found when reading from the json reader

于是我尝试批量请求方式：

var requestbody = new ReferenceCreate
{
    OdataId = graphClient.DirectoryObjects[userid].ToGetRequestInformation().URI.ToString(),
};

try
{
    var batchRequestContent = new BatchRequestContentCollection(graphClient);

    foreach (String i in groupids)
    {
        var requestStepId = await batchRequestContent.AddBatchRequestStepAsync(graphClient.Groups[i].Members.Ref.ToPostRequestInformation(requestbody));
    }

    var batchResponse = await graphClient.Batch.PostAsync(batchRequestContent);
}

但批量方式同样仅能成功添加用户到一个组，其余步骤返回：

Bad Request

不过在Graph Explorer中执行相同操作却能正常完成。我使用的ID均正确，切换组列表顺序后仍是第一个组成功，其余失败。请问我的问题出在哪里？在Graph API SDK V5中是否有简便的方法将单个用户添加到多个组？

问题根源 #

你遇到的核心问题是复用了同一个ReferenceCreate实例。Graph API SDK V5中，ReferenceCreate对象在首次序列化后，内部状态会被修改（比如内容被清空），再次复用该实例发起请求时，会因为请求体为空导致序列化错误或Bad Request，这就是为什么只有第一个组添加成功，后续全部失败。

单请求循环的正确写法 #

在每次循环中创建新的ReferenceCreate实例，确保每个请求的请求体都是独立的：

foreach (string groupId in groupids)
{
    // 每次循环都新建ReferenceCreate实例
    var requestBody = new ReferenceCreate
    {
        OdataId = graphClient.DirectoryObjects[userid].ToGetRequestInformation().Uri.ToString()
    };
    await graphClient.Groups[groupId].Members.Ref.PostAsync(requestBody);
}

批量请求的正确写法 #

批量请求同样需要为每个步骤创建独立的ReferenceCreate实例，避免复用导致的请求体异常：

try
{
    var batchRequestContent = new BatchRequestContentCollection(graphClient);

    foreach (string groupId in groupids)
    {
        var requestBody = new ReferenceCreate
        {
            OdataId = graphClient.DirectoryObjects[userid].ToGetRequestInformation().Uri.ToString()
        };
        // 基于独立的请求体生成请求信息
        var requestInfo = graphClient.Groups[groupId].Members.Ref.ToPostRequestInformation(requestBody);
        await batchRequestContent.AddBatchRequestStepAsync(requestInfo);
    }

    var batchResponse = await graphClient.Batch.PostAsync(batchRequestContent);

    // 可选：遍历批量响应验证结果
    foreach (var stepResponse in await batchResponse.GetResponsesAsync())
    {
        if (stepResponse.Value.IsSuccessStatusCode)
        {
            // 处理添加成功的逻辑
        }
        else
        {
            // 处理错误，比如读取错误内容
            var errorMsg = await stepResponse.Value.Content.ReadAsStringAsync();
        }
    }
}
catch (Exception ex)
{
    // 捕获全局异常
}

更简便的实现思路 #

如果使用的是Graph SDK v5.7及以上版本，除了上述方式外，也可以直接利用SDK的批量请求能力简化代码，但核心原则始终是每个请求使用独立的请求体实例，避免复用导致的状态异常。

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