Blazor Server(.NET8)自定义认证状态提供者路由组件授权异常求助

核心原因 #

全局交互模式下，Blazor Server的路由组件级别的[Authorize]属性会触发后端认证管道的校验，你仅实现了前端的CustomAuthenticationStateProvider，但后端未注册对应的认证Handler，导致管道找不到校验逻辑抛出异常。

具体解决步骤 #

1. 注册认证服务并配置自定义Scheme #

在Program.cs中添加认证服务，注册自定义Scheme并设置为默认值：

builder.Services.AddAuthentication(options =>
{
    options.DefaultAuthenticateScheme = "custom";
    options.DefaultChallengeScheme = "custom";
})
.AddScheme<CustomAuthSchemeOptions, CustomAuthHandler>("custom", options => { });

2. 实现自定义认证Handler #

创建极简版认证Handler，适配前端CustomAuthenticationStateProvider的认证状态（若需后端校验逻辑，可在此扩展）：

public class CustomAuthHandler : AuthenticationHandler<CustomAuthSchemeOptions>
{
    public CustomAuthHandler(IOptionsMonitor<CustomAuthSchemeOptions> options, ILoggerFactory logger, UrlEncoder encoder, ISystemClock clock)
        : base(options, logger, encoder, clock)
    {
    }

    protected override Task<AuthenticateResult> HandleAuthenticateAsync()
    {
        // 基于前端AuthenticationStateProvider的状态，直接返回认证成功
        var identity = new ClaimsIdentity("custom");
        var principal = new ClaimsPrincipal(identity);
        var ticket = new AuthenticationTicket(principal, "custom");

        return Task.FromResult(AuthenticateResult.Success(ticket));
    }
}

// 自定义Scheme的空配置类
public class CustomAuthSchemeOptions : AuthenticationSchemeOptions
{
}

3. 启用认证中间件 #

在Program.cs的管道配置中，添加认证&授权中间件（顺序需在Blazor路由之前）：

app.UseAuthentication();
app.UseAuthorization();

app.MapBlazorHub();
app.MapFallbackToPage("/_Host");

4. 配置路由组件的授权属性 #

现在可直接使用以下两种方式之一：

@* 方式1：指定自定义Scheme *@
@attribute [Authorize(AuthenticationSchemes = "custom")]

@* 方式2：使用默认Scheme（已在Program.cs配置） *@
@attribute [Authorize]

额外说明 #

• 若需后端参与真实校验，可在HandleAuthenticateAsync中添加逻辑（如验证凭证、查询用户权限等）。
• 需确保前端CustomAuthenticationStateProvider与后端认证逻辑的状态一致，避免前后端权限不匹配。

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