Blazor客户端AuthenticationStateProvider如何设置用户未登录状态

你写的两种实现抛出空引用异常的核心原因：AuthenticationState构造函数强制要求传入非空的ClaimsPrincipal实例，既不允许直接返回null值的AuthenticationState，也不允许给构造函数传入null参数。
客户端Blazor（WASM模式）的认证模型和服务端ASP.NET Core鉴权管道是独立设计的，不存在服务端场景下AuthenticateResult.Fail()对应的方法，标记未登录状态不需要调用特殊方法，返回一个身份为空的匿名ClaimsPrincipal即可。

正确实现代码 #

public class CustomAuthStateProvider : AuthenticationStateProvider
{
    public override Task<AuthenticationState> GetAuthenticationStateAsync()
    {
        // 执行你自己的登录校验逻辑，比如读取本地缓存的token、校验有效期
        bool isAuthenticated = false; // 替换为实际校验结果

        if (!isAuthenticated)
        {
            // 空构造的ClaimsIdentity代表匿名未认证身份，其IsAuthenticated属性默认返回false
            var anonymousPrincipal = new ClaimsPrincipal(new ClaimsIdentity());
            return Task.FromResult(new AuthenticationState(anonymousPrincipal));
        }

        // 已登录用户的返回逻辑：注意必须给ClaimsIdentity指定authenticationType参数，否则即使传入声明也会被判定为未认证
        var authenticatedPrincipal = new ClaimsPrincipal(
            new ClaimsIdentity(
                claims: new List<Claim>
                {
                    new Claim(ClaimTypes.Name, "实际用户名"),
                    // 按需添加角色、用户ID等其他声明
                },
                authenticationType: "CustomAuthScheme"
            )
        );
        return Task.FromResult(new AuthenticationState(authenticatedPrincipal));
    }
}

关键注意事项 #

• 禁止返回null的AuthenticationState实例，也禁止给AuthenticationState构造函数传null，否则框架内部遍历身份信息时必然抛出空引用异常。
• 未登录场景下不要给ClaimsIdentity传任何认证类型参数，空构造的实例就会被框架识别为未认证用户，[Authorize]特性会自动拦截访问、重定向到登录页。
• 处理登录/退出这类主动变更认证状态的场景时，直接调用基类的NotifyAuthenticationStateChanged方法传入新状态即可，无需刷新页面，示例退出逻辑：

public void Logout()
{
    // 先清理本地存储的token等登录凭证
    var anonymousPrincipal = new ClaimsPrincipal(new ClaimsIdentity());
    var authState = Task.FromResult(new AuthenticationState(anonymousPrincipal));
    NotifyAuthenticationStateChanged(authState);
}

• 服务端场景下的Fail()方法属于AuthenticateResult类的管道逻辑，和Blazor WASM客户端的AuthenticationStateProvider状态模型完全无关，客户端不存在对应实现，无需查找该方法。

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