自定义AuthenticationStateProvider中GetAuthenticationStateAsync()未被调用

可能原因及对应解决方法 #

1. App.razor组件包裹错误 #

现有项目的App.razor可能未正确用CascadingAuthenticationState包裹路由组件，导致启动时未触发认证状态获取。
检查并修正为如下结构：

<CascadingAuthenticationState>
    <Router AppAssembly="@typeof(App).Assembly">
        <Found Context="routeData">
            <RouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
            <FocusOnNavigate RouteData="@routeData" Selector="h1" />
        </Found>
        <NotFound>
            <PageTitle>Not found</PageTitle>
            <LayoutView Layout="@typeof(MainLayout)">
                <p role="alert">Sorry, there's nothing at this address.</p>
            </LayoutView>
        </NotFound>
    </Router>
</CascadingAuthenticationState>

2. Program.cs中服务/中间件顺序错误 #

中间件或服务注册顺序混乱会导致自定义状态提供者未被优先加载。确保代码顺序如下：

// 服务注册：替换默认的AuthenticationStateProvider
builder.Services.AddScoped<AuthenticationStateProvider, CustomAuthenticationStateProvider>();

// 中间件注册：认证、授权要在Blazor Hub之前
app.UseAuthentication();
app.UseAuthorization();

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

3. 现有项目存在认证配置冲突 #

如果项目中配置了其他认证方案（如Cookie认证、OIDC），可能覆盖了自定义状态提供者的逻辑。检查Program.cs中是否有多余的认证配置，确保没有强制指定其他认证状态来源。

4. 根组件初始化逻辑异常 #

检查_Host.cshtml是否正确引入Blazor脚本，且没有在初始化时跳过认证状态获取。确保页面包含核心脚本引用：

<script src="_framework/blazor.server.js"></script>

调试验证步骤 #

1. 在自定义提供者的GetAuthenticationStateAsync方法中添加日志，确认是否被调用：

public override async Task<AuthenticationState> GetAuthenticationStateAsync()
{
    Console.WriteLine("GetAuthenticationStateAsync 已触发");
    // 测试逻辑
    var emptyIdentity = new ClaimsIdentity();
    return await Task.FromResult(new AuthenticationState(new ClaimsPrincipal(emptyIdentity)));
}

2. 对比新建项目与现有项目的App.razor、Program.cs、_Host.cshtml文件，定位配置差异。
3. 查看服务器日志和浏览器控制台，排查是否有异常中断认证流程。

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