C# xUnit高并行测试时HttpClient.PostAsync()永久挂死如何解决

问题根因 #

这类高并发下的永久挂死是同步上下文死锁 + 连接并发阈值打满的组合问题，和PostAsync的内部实现逻辑直接相关：

• xUnit 2.x及以上版本默认采用单线程同步上下文调度同集合内的测试用例，不会为每个用例分配独立线程池线程。当并行度升高到50个用例时，首先会触发HttpClient的默认并发连接限制。
• 此前GetAsync添加.ConfigureAwait(false)后修复问题，是因为GetAsync无请求体，内部await调用链路短，外层配置即可覆盖全链路，不需要切回原始同步上下文。但PostAsync存在请求体处理逻辑，内置的HttpContent（如StringContent、FormUrlEncodedContent）在序列化、分块传输的内部await逻辑默认会捕获原始同步上下文，即便你在PostAsync外层加了.ConfigureAwait(false)，只要内部链路有一个await点未配置，就会尝试回到已被阻塞的单线程同步上下文，形成闭环死锁：同步上下文线程被阻塞等待PostAsync返回，PostAsync内部逻辑等待同步上下文线程空闲才能执行。
• 低并行度（5-6个用例）时不会触发HttpClient的连接等待队列，请求可以即时发送处理，因此不会触发死锁；并行度升高后，同域名请求超过默认连接阈值，部分请求进入连接等待队列，等待调度的任务一旦被分配到已阻塞的同步上下文线程，就会永久挂起。
• 注意：.NET Framework下针对单域名默认最大并发连接数仅为2，.NET Core/.NET 5+虽然默认连接数无硬限制，但如果混用同步阻塞调用（.Result/.Wait()/GetAwaiter().GetResult()），依然会触发死锁。

可行修复方案 #

• 全链路移除同步阻塞写法：所有异步方法调用统一使用await，禁止在测试代码、请求封装逻辑中混用任何同步阻塞异步的方法。所有await点（包括自定义的HttpContent实现、业务封装层代码）全部添加.ConfigureAwait(false)，不要只在PostAsync最外层加配置。
• 显式提升HttpClient并发连接阈值：
  .NET Core/.NET 5+ 环境下创建HttpClient时显式配置连接数：

  var socketsHandler = new SocketsHttpHandler
  {
      MaxConnectionsPerServer = 100 // 配置值大于测试最大并行度即可
  };
  var httpClient = new HttpClient(socketsHandler);
  

  .NET Framework 环境下在测试初始化阶段全局配置连接限制：

  ServicePointManager.DefaultConnectionLimit = 100;
  

• 调整xUnit并行调度配置：在测试项目根目录添加xunit.runner.json并设置为复制到输出目录，调整并行线程数、放开集合并行限制，避免所有用例挤在同一个单线程同步上下文队列：

  {
    "parallelizeAssembly": true,
    "parallelizeTestCollections": true,
    "maxParallelThreads": 100
  }
  

• 检查PostAsync传入的请求内容：避免在发起请求前对HttpContent做预读取、预序列化操作，自定义HttpContent的内部IO逻辑必须全部添加.ConfigureAwait(false)。

修复后可以从20并行度开始逐步提升压测量验证，正常情况下哪怕接口返回限流错误，也不会出现永久挂死的情况。

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