.NET Framework 4.6.1下使用HttpClient调用Microsoft Graph认证无响应

问题产生原因 #

• 同步上下文死锁：SharePoint WebPart 基于 ASP.NET 运行，.NET Framework 4.6.1 版本的 ASP.NET 默认存在专属同步上下文。如果上层代码调用异步方法时使用了 .Wait()、.Result 这类阻塞主线程的写法，同时异步方法内部 await 没有指定不捕获同步上下文，就会触发死锁：主线程一直在等待异步任务返回，而异步任务执行完成后需要回到原同步上下文才能继续执行，但是同步上下文已经被阻塞的主线程占用，最终程序无限卡住无响应。
• TLS 版本不兼容：.NET Framework 4.6.1 默认使用 TLS 1.0 作为安全协议，而微软身份平台、Microsoft Graph 早已停止支持 TLS 1.0/1.1，请求会被服务端直接拦截，也会导致调用无返回卡住。
• 网络代理限制：SharePoint 服务器通常会配置企业内网代理，未配置代理规则的对外请求无法发送到微软公网接口，同样会出现无限等待的情况。

解决方案 #

1. 修复异步死锁 #

所有异步调用后追加 ConfigureAwait(false)，避免异步执行完成后尝试回到原同步上下文：

// 获取token的调用添加ConfigureAwait(false)
var authenticationResult = await app.AcquireTokenForClient(scopes).ExecuteAsync().ConfigureAwait(false);

// 后续所有HttpClient异步调用也统一添加
HttpResponseMessage response = await client.GetAsync(url).ConfigureAwait(false);
var resp = await response.Content.ReadAsStringAsync().ConfigureAwait(false);

如果上层代码必须用同步方式调用这段异步逻辑，建议用 Task.Run 包裹避免死锁：

// 同步调用的安全写法
var userInfo = Task.Run(async () => await GetGraphUserAsync()).Result;

2. 显式指定TLS 1.2协议 #

在所有对外请求执行前，添加配置启用 TLS 1.2：

// 可放在方法开头，或者项目全局初始化位置
System.Net.ServicePointManager.SecurityProtocol |= System.Net.SecurityProtocolType.Tls12;

3. 配置网络代理 #

在 SharePoint 站点的 web.config 中添加全局代理配置，允许请求对外发送：

<system.net>
  <defaultProxy useDefaultCredentials="true" enabled="true">
    <proxy usesystemdefault="True" />
  </defaultProxy>
</system.net>

4. 增加超时和异常捕获 #

添加超时逻辑避免无限等待，同时捕获异常排查具体报错：

// 设置30秒超时
var cts = new CancellationTokenSource(TimeSpan.FromSeconds(30));
try
{
    var authenticationResult = await app.AcquireTokenForClient(scopes)
        .ExecuteAsync(cts.Token)
        .ConfigureAwait(false);
}
catch (Exception ex)
{
    // 输出异常信息排查问题
    test.Text = ex.ToString();
}

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