Blazor Server异步Task未抛异常致应用冻结的问题与解决办法

这不是.NET调试器的bug #

Blazor Server对组件事件中异步方法抛出的异常有特定处理逻辑，结合调试器默认的异常捕获设置，才导致你遇到的现象：

• 同步方法/无async的Task方法抛出的异常是立即同步抛出，调试器能直接捕获并中断；
• 带async关键字但无await的Task方法，异常会被包装在返回的Task对象中，属于「未观察到的Task异常」。Blazor框架的调度器会在后续处理该Task时捕获异常，但调试器默认只监听「抛出时未被任何代码处理」的异常，因此不会主动中断，最终导致应用因未处理的异常冻结。

强制调试器捕获该异常的方法 #

• 调整调试器异常设置：
  打开Visual Studio的「调试」→「Windows」→「异常设置」，勾选「Common Language Runtime Exceptions」下的「抛出」选项（默认仅勾选「用户未处理」）。这样无论异常是否被后续代码处理，只要抛出就会触发调试器中断。
• 给异步方法添加await操作：
  确保async方法中包含至少一个await，让异常在await点抛出，调试器会正常捕获：

  private async Task IncrementCount()
  {
      currentCount++;
      await Task.CompletedTask; // 添加无意义的await满足异步规范
      throw new Exception("test");
  }
  

避免该问题的最佳实践 #

• 遵循异步编程规范：
  若方法内没有实际异步操作，不要使用async Task，直接用同步方法或返回Task.FromException来抛出异常：

  private Task IncrementCount()
  {
      currentCount++;
      return Task.FromException(new Exception("test"));
  }
  

• 配置全局异常处理：
  在Program.cs中开启详细错误，并添加全局异常处理逻辑，避免应用冻结：

  builder.Services.AddServerSideBlazor()
      .AddCircuitOptions(options =>
      {
          options.DetailedErrors = true; // 开发环境显示详细错误
      });
  

• 使用错误边界组件：
  在页面或组件外层包裹ErrorBoundary组件，捕获并处理局部异常，不影响整个应用：

  <ErrorBoundary>
      <ChildContent>
          <!-- 你的计数器页面内容 -->
          <p>当前计数: @currentCount</p>
          <button @onclick="IncrementCount">点击 me</button>
      </ChildContent>
      <ErrorContent>
          <p>发生了错误，请重试。</p>
      </ErrorContent>
  </ErrorBoundary>
  

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