.NET 8 Blazor Server中HttpClient超时无异常问题咨询

在.NET 8的Blazor Server应用中，向外部服务器发送HTTP请求并设置35秒超时后，若未收到响应，按照以往HttpClient的行为预期会抛出TaskCanceledException: A task was canceled，但出现了两种不同的异常表现：

异步非阻塞代码（无异常） #

private async Task<HttpResponseModel> PostAsync(string url, object request)
{
      httpClient.Timeout = TimeSpan.FromSeconds(35);
      var response = await httpClient.PostAsJsonAsync(address, request);
      return await GetResponseResult(response);
}

阻塞调用.Result代码（触发预期异常） #

private async Task<HttpResponseModel> PostAsync(string url, object request)
{
      httpClient.Timeout = TimeSpan.FromSeconds(35);
      var response = httpClient.PostAsJsonAsync(address, request).Result;
      return await GetResponseResult(response);
}

完整调用链代码 #

HttpClientService.cs

public class HttpClientService(HttpClient httpClient)
{
    public async Task<HttpResponseModel> PostAsync(string address, object request)
    {
        httpClient.Timeout = TimeSpan.FromSeconds(35);
        var response = await httpClient.PostAsJsonAsync(address, request);
        return await GetResponseResult(response, request);
    }
}

SmsService.cs

public class SmsService(HttpClientService httpClient) : ISmsService
{
    public async Task<SendOtpResult> SendOtpAsync(SendOtpRequest request)
    {
        var response = await httpClient.PostAsync("[address]", request);
        //...       
    }
}

组件代码

@inject ISmsService SmsService

protected override async Task OnInitializedAsync()
{
    var result = await SmsService.SendOtpAsync();
}

DI注册代码

services.AddHttpClient<HttpClientService>(client =>
{
    client.BaseAddress = new Uri("[base address]");
});

services.AddScoped<ISmsService, SmsService>();

核心疑问 #

已知可通过try/catch处理异常，但为何两种写法一个触发未处理异常，另一个却不会？

原因分析 #

异步await写法的异常处理逻辑 #

使用await的异步代码中，HTTP超时抛出的TaskCanceledException会被封装到PostAsJsonAsync返回的Task对象里。当你await该Task时，异常会被抛出，但Blazor Server的组件生命周期方法（如OnInitializedAsync）受内置异常处理机制管控：

• Blazor会自动将异步异常路由到组件级错误处理（比如ErrorBoundary组件）或全局异常处理管道；
• 这种情况下异常不会以“未处理异常”的形式暴露到控制台或导致应用崩溃，除非你完全没有配置错误处理逻辑。

阻塞调用.Result的异常处理逻辑 #

用.Result同步阻塞等待Task完成时：

• Task内部的异常会被包装成AggregateException直接抛出；
• 同步调用绕过了Blazor的异步同步上下文处理流程，异常直接进入普通同步异常流；
• 若未手动捕获，就会触发未处理异常，被CLR全局异常捕获机制处理（比如在控制台输出异常信息）。

额外提示 #

你当前每次调用PostAsync时都修改httpClient.Timeout，但HttpClient是DI注入的实例，若存在并发请求，修改Timeout会引发线程安全问题。建议在DI注册阶段就统一设置Timeout，而非每次调用时修改：

services.AddHttpClient<HttpClientService>(client =>
{
    client.BaseAddress = new Uri("[base address]");
    client.Timeout = TimeSpan.FromSeconds(35); // 注册时设置超时
});

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