如何在Blazor WASM中终止HTTP拦截器执行链路？

要实现遇到401状态码时终止拦截器链路并直接重定向到登录页，核心是通过自定义委托处理程序优先处理响应，修改响应避免后续链路触发异常，具体步骤如下：

1. 创建Unauthorized委托处理程序 #

实现一个继承自DelegatingHandler的类，注入NavigationManager处理页面跳转，在SendAsync方法中检查响应状态码：

using System.Net;
using System.Net.Http;
using System.Threading;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Components;

public class UnauthorizedDelegatingHandler : DelegatingHandler
{
    private readonly NavigationManager _navigationManager;

    public UnauthorizedDelegatingHandler(NavigationManager navigationManager)
    {
        _navigationManager = navigationManager;
    }

    protected override async Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        // 发送请求获取响应
        var response = await base.SendAsync(request, cancellationToken);

        // 拦截401未授权响应
        if (response.StatusCode == HttpStatusCode.Unauthorized)
        {
            // 重定向到登录页，forceLoad设为true会强制刷新页面，内部路由可设为false
            _navigationManager.NavigateTo("/login", forceLoad: false);

            // 返回已处理的响应，避免后续拦截器或客户端抛出异常
            return new HttpResponseMessage(HttpStatusCode.OK)
            {
                Content = new StringContent("已重定向至登录页面")
            };
        }

        // 非401场景，正常传递响应给后续链路
        return response;
    }
}

2. 注册处理程序到依赖注入容器 #

在Program.cs中，将UnauthorizedDelegatingHandler注册为Scoped服务（匹配NavigationManager的生命周期）：

builder.Services.AddScoped<UnauthorizedDelegatingHandler>();

3. 配置HttpClient的拦截器链 #

注册HttpClient时，优先添加UnauthorizedDelegatingHandler，确保它在响应链路的最前端最先处理响应，再添加其他自定义拦截器：

builder.Services.AddHttpClient("MyApiClient")
    // 第一个添加，确保响应返回时最先被处理
    .AddHttpMessageHandler<UnauthorizedDelegatingHandler>()
    // 后续添加其他拦截器
    .AddHttpMessageHandler<OtherCustomHandler1>()
    .AddHttpMessageHandler<OtherCustomHandler2>();

关键细节说明 #

• 链路顺序逻辑：AddHttpMessageHandler的添加顺序决定了拦截器执行顺序：请求时从后往前遍历拦截器，响应时从前往后遍历。将UnauthorizedDelegatingHandler第一个添加，能让它最先捕获401响应，处理后返回的非401响应会直接传递给后续拦截器，避免触发异常。
• 异常规避：返回修改后的响应（如200状态码）是为了防止后续拦截器或HttpClient因401状态码抛出异常。若业务允许，也可保留原401响应，但需确保后续逻辑不会对该状态码做额外错误处理。
• 重定向选项：NavigateTo的forceLoad参数根据场景选择：若登录页是外部页面或需要清除客户端状态，设为true强制刷新；若为Blazor内部路由，设为false实现无刷新导航。

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