使用GraphClientService无法更新用户，报HTTP方法不允许错误

问题场景 #

在.NET Framework 4.6.2项目中使用最新版Microsoft.Graph和Microsoft.Graph.Core库，查询用户操作成功，但调用UpdateAsync更新用户时触发以下错误：

{"error":{"code":"Request_BadRequest","message":"Specified HTTP method is not allowed for the request target.","innerError":{"date":"2022-11-04T18:13:06","request-id":"","client-request-id":""}}}

相关代码片段：

var builder = ConfidentialClientApplicationBuilder.CreateWithApplicationOptions(new ConfidentialClientApplicationOptions()
{
    ClientId = "appId",
    ClientSecret = "clientSecret",
    TenantId = "tenantId"
});

var client = new GraphServiceClient(
    new MicrosoftGraphAuthProvider(
        builder.Build(), 
        new string[]{"https://graph.microsoft.com/.default" }));

var user = new Microsoft.Graph.User()
{
    GivenName = "test",
    Surname = "test",
    Mail = "test@testmail.com"                
};

var originalUser = await client.Users[upn]
    .Request()
    .Select("displayName")
    .GetAsync();

await client.Users[originalUser.Id]
    .Request()
    .UpdateAsync(user);

排查与解决思路 #

1. 排查自定义AuthProvider的问题 #

你使用了自定义的MicrosoftGraphAuthProvider，这是最可能的问题点：

• 检查该类的实现，确认是否在处理请求时意外修改了HTTP方法（比如把PATCH改成了POST/GET），或者篡改了请求URL路径。
• 临时替换为官方的ClientCredentialProvider测试：

  var clientCredentialProvider = new ClientCredentialProvider(builder.Build());
  var client = new GraphServiceClient(clientCredentialProvider);
  

  如果替换后更新成功，说明自定义AuthProvider存在逻辑错误。

2. 验证实际请求的HTTP方法与端点 #

通过抓包工具（如Fiddler）查看实际发送的请求：

• 确认请求方法是PATCH（Microsoft Graph更新用户要求用PATCH方法）。
• 确认请求URL是https://graph.microsoft.com/v1.0/users/{user-id}，没有被错误路由到其他端点。

3. 检查应用权限配置 #

虽然报错提示方法不允许，但权限不足也可能导致异常表现：

• 登录Azure AD应用注册后台，确认已添加User.ReadWrite.All或Directory.ReadWrite.All的应用权限（而非委托权限）。
• 确认该权限已获得管理员同意。

4. 排查更新属性的合法性 #

部分用户属性无法直接通过UpdateAsync修改：

• 比如Mail属性，部分租户中需要通过设置ProxyAddresses（添加SMTP:test@testmail.com）来更新，而非直接赋值Mail字段。
• 尝试只更新一个简单属性（如DisplayName）测试：

  var user = new Microsoft.Graph.User()
  {
      DisplayName = "Updated Test Name"
  };
  await client.Users[originalUser.Id].Request().UpdateAsync(user);
  

  如果此操作成功，说明是特定属性的更新限制导致的问题。

5. 检查库版本兼容性 #

最新版Microsoft Graph库可能对.NET Framework 4.6.2的支持存在兼容性问题：

• 尝试降级到稳定的旧版本（如Microsoft.Graph 4.x系列），重新测试更新操作。

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