.NET 4.7.2 Web API中HttpClient PostAsync报TaskCanceled异常

这个异常在ASP.NET Web API（非Core）场景下，核心原因是同步上下文死锁触发HttpClient超时，和控制台环境的差异点如下：

• 控制台应用不存在专属请求同步上下文，用.Result阻塞异步任务时，线程池线程可以直接接续回调逻辑，不会死锁；但.NET Framework下的ASP.NET Web API有独立的请求同步上下文，异步方法的回调必须重新获取原请求上下文才能执行。你代码中全程用.Result阻塞了原请求线程，回调拿不到上下文就会一直卡住，等到HttpClient默认100秒超时触发，就会抛出包装为TaskCanceledException的超时错误，和请求头、编码配置没有关系。
• 你当前代码还有两个额外问题，虽然不是本次异常的直接诱因，但会引发其他故障：
  1. 用using包裹每次新建的HttpClient，会导致套接字资源无法及时释放，高并发下会出现随机请求失败。
  2. 代码存在笔误：if (response.IsSuccessStatusCode)中的response变量未定义，实际运行时应该是引用了PostAsync返回的响应对象。

修复方案 #

1. 全链路使用async/await异步调用，禁止用.Result、.Wait()同步阻塞异步方法，这是.NET Framework下ASP.NET异步编程的基本准则。
2. 将HttpClient声明为静态单例，不要每次调用都新建实例。
3. 所有异步调用后追加.ConfigureAwait(false)，告知运行时不需要将回调调度回原请求同步上下文，从根源上避免死锁。

修正后的参考代码：

// 静态单例HttpClient，全局复用
private static readonly HttpClient _httpClient = new HttpClient()
{
    Timeout = TimeSpan.FromSeconds(30) // 显式设置超时时间，方便排查问题
};

// 调用方法必须标记为async，返回值使用Task包装
public async Task<string> CallTargetApiAsync(ApiRequestData data, RASModel rAS)
{
    // 每次设置头前先清除旧值，避免重复头报错
    _httpClient.DefaultRequestHeaders.Accept.Clear();
    _httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
    _httpClient.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", data.token);
    _httpClient.DefaultRequestHeaders.Remove("Ocp-Apim-Subscription-Key");
    _httpClient.DefaultRequestHeaders.Add("Ocp-Apim-Subscription-Key", "b75b570ad98148968beac9510ecaba6a");
    _httpClient.DefaultRequestHeaders.Remove("Ocp-Apim-Trace");
    _httpClient.DefaultRequestHeaders.Add("Ocp-Apim-Trace", "false");
    _httpClient.DefaultRequestHeaders.TransferEncodingChunked = false;

    using (var requestContent = new StringContent(new JavaScriptSerializer().Serialize(rAS), Encoding.UTF8, "application/json"))
    {
        // 用await异步等待，不要用.Result
        var response = await _httpClient.PostAsync(data.url, requestContent).ConfigureAwait(false);
        if (response.IsSuccessStatusCode)
        {
            return await response.Content.ReadAsStringAsync().ConfigureAwait(false);
        }
        // 抛出错误时携带响应内容，方便定位接口侧问题
        var errorMsg = await response.Content.ReadAsStringAsync().ConfigureAwait(false);
        throw new HttpRequestException($"接口调用失败，状态码：{response.StatusCode}，错误信息：{errorMsg}");
    }
}

快速验证方法 #

如果暂时无法将全链路改成异步，可以先把PostAsync的调用逻辑包裹在Task.Run中执行，脱离ASP.NET请求同步上下文：

var postTask = Task.Run(() => _httpClient.PostAsync(data.url, new StringContent(
    new JavaScriptSerializer().Serialize(rAS), Encoding.UTF8, "application/json"))).Result;

如果修改后请求正常，即可100%确认是同步上下文死锁导致的异常。该方法仅适合临时验证，生产环境必须使用全异步写法。

临时兼容方案：如果受历史代码限制无法改造为全异步，可将所有.Result替换为.ConfigureAwait(false).GetAwaiter().GetResult()，同时在应用启动时配置ServicePointManager.Expect100Continue = false;，可以降低死锁概率，但不是长期解决方案。

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