.NET 8 Blazor独立身份认证下HttpClient配置报错排查

1. 客户端必须注册Blazor WebAssembly身份认证服务 #

IAccessTokenProvider 是由 Microsoft.AspNetCore.Components.WebAssembly.Authentication 包提供的服务，只有在客户端正确配置身份认证后，这个服务才会被注入到DI容器中。

在客户端的 Program.cs 中，必须添加以下配置（替换掉你现有的认证相关代码，如果有的话）：

builder.Services.AddApiAuthorization();

或者如果你需要自定义OIDC配置，可以用：

builder.Services.AddOidcAuthentication(options =>
{
    // 这里可以配置OIDC参数，比如Authority、ClientId等
    // 对于Individual Account模板，这些配置通常从appsettings.json读取
    builder.Configuration.Bind("Local", options.ProviderOptions);
});

注意：如果是用Visual Studio的Blazor Web App模板创建的带Individual Account的项目，客户端默认已经包含这个配置，但如果你手动修改了Program.cs，可能不小心删掉了。

2. 正确注册CustomAuthorizationMessageHandler #

确保你的 CustomAuthorizationMessageHandler 通过DI注册，并且在配置HttpClient时正确引用：

// 注册自定义消息处理器
builder.Services.AddScoped<CustomAuthorizationMessageHandler>();

// 配置HttpClient并添加消息处理器
builder.Services.AddHttpClient("ApiClient", client =>
{
    client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress);
})
.AddHttpMessageHandler<CustomAuthorizationMessageHandler>();

这里的CustomAuthorizationMessageHandler必须继承AuthorizationMessageHandler，构造函数需接收IAccessTokenProvider和NavigationManager：

public class CustomAuthorizationMessageHandler : AuthorizationMessageHandler
{
    public CustomAuthorizationMessageHandler(IAccessTokenProvider provider, NavigationManager navManager)
        : base(provider, navManager)
    {
        // 配置需要附加令牌的API地址前缀
        ConfigureHandler(authorizedUrls: new[] { "/api" });
    }
}

3. 服务器端确认身份认证配置 #

服务器端需要确保API端点能验证客户端发送的JWT令牌，对于Individual Account模板，服务器端的Program.cs应包含以下配置：

builder.Services.AddAuthentication()
    .AddIdentityServerJwt();

// 确保端点配置授权
app.MapControllers().RequireAuthorization();

不需要额外手动添加JwtBearer配置，AddIdentityServerJwt()已经封装了所需的JWT验证逻辑。

常见误区 #

• 不要在客户端手动注册IAccessTokenProvider，这个服务由AddApiAuthorization或AddOidcAuthentication自动注册，手动注册会导致冲突。
• 确保CustomAuthorizationMessageHandler的构造函数参数正确，且继承自AuthorizationMessageHandler而非直接的DelegatingHandler。

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