Blazor WASM托管应用报错：未注册BaseAddressAuthorizationMessageHandler服务

问题概述 #

在托管式Blazor WASM应用中完成Azure AD登录后，调用后端API时触发以下错误，导致API返回500内部服务器错误：

System.InvalidOperationException: No service for type 'Microsoft.AspNetCore.Components.WebAssembly.Authentication.BaseAddressAuthorizationMessageHandler' has been registered.

已确认服务器端API端点持有有效的JWT且授权配置正常，但依赖注入容器无法识别该消息处理器服务。

核心原因 #

BaseAddressAuthorizationMessageHandler是Blazor WASM身份验证库提供的专属消息处理器，用于自动为API请求附加Bearer令牌，但该服务未在客户端的依赖注入容器中正确注册。

修复步骤 #

1. 确认安装必要NuGet包 #

确保Blazor WASM客户端项目已安装身份验证依赖包：

dotnet add package Microsoft.AspNetCore.Components.WebAssembly.Authentication

2. 修正Program.cs的服务注册顺序 #

在客户端Program.cs中，必须先注册身份验证服务，再配置使用该消息处理器的HttpClient，示例代码如下：

// 第一步：注册Azure AD身份验证服务
builder.Services.AddMsalAuthentication(options =>
{
    builder.Configuration.Bind("AzureAd", options.ProviderOptions.Authentication);
    // 添加API所需的访问Scope
    options.ProviderOptions.DefaultAccessTokenScopes.Add("api://{你的API客户端ID}/access_as_user");
});

// 第二步：配置带有授权消息处理器的HttpClient
builder.Services.AddHttpClient("ServerAPI", client => 
    client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress))
    .AddHttpMessageHandler<BaseAddressAuthorizationMessageHandler>();

// 可选：注册强类型API客户端（如果使用）
builder.Services.AddScoped<IServerApiClient>(sp => 
    new ServerApiClient(sp.GetRequiredService<IHttpClientFactory>().CreateClient("ServerAPI")));

3. 关键注意事项 #

• 注册顺序不可颠倒：身份验证服务AddMsalAuthentication会自动注册BaseAddressAuthorizationMessageHandler，如果先配置HttpClient再注册身份验证，会导致服务找不到。
• 服务器端禁用该Handler：BaseAddressAuthorizationMessageHandler是Blazor WASM客户端专属组件，绝对不要在ASP.NET Core服务器项目中尝试注册或使用它。
• Scope匹配验证：确保客户端配置的AccessToken Scope与服务器端JWT验证的受众（Audience）完全一致。

4. 验证修复 #

重启应用后，完成Azure AD登录并访问API页面，确认错误消失，请求能正常携带Bearer令牌并获取200响应。

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