AuthenticationStateProvider是Blazor中广播用户认证状态的核心服务,需继承并重写GetAuthenticationStateAsync(),调用NotifyAuthenticationStateChanged通知UI更新,注册为Scoped(Server)或Singleton(WASM),配合CascadingAuthenticationState使用。

Blazor 的 AuthenticationStateProvider 是实现自定义身份验证逻辑的核心组件,它负责向整个应用提供当前用户的认证状态(比如是否已登录、用户身份信息等)。默认情况下,Blazor Server 和 Blazor WebAssembly 的基础模板已集成 Identity 或 JWT 认证,但若需对接自有登录系统、Token 存储在 localStorage、或需要手动触发状态刷新,你就得自定义一个 AuthenticationStateProvider。
理解 AuthenticationStateProvider 的作用
它不是“做登录”的工具,而是“广播登录状态”的服务。Blazor 组件(如 AuthorizeView、AuthorizeRouteView)会订阅它的状态变更,从而动态显示/隐藏内容或跳转路由。它内部维护一个 Task,并通过 NotifyAuthenticationStateChanged 方法通知所有监听者状态已更新。
关键点:
必须注册为 Scoped(Blazor Server)或 Singleton(Blazor WebAssembly),且早于 AuthenticationStateProvider 的消费者(如 CascadingAuthenticationState)注册 重写 GetAuthenticationStateAsync() 返回当前状态(同步或异步获取用户信息) 调用 NotifyAuthenticationStateChanged(Task) 才能触发 UI 更新
手写一个基于 localStorage 的 Provider(WebAssembly 场景)
适用于 JWT 登录后把 token 存在浏览器 localStorage,页面刷新后仍需恢复登录态的场景。
步骤如下:
新建类继承 AuthenticationStateProvider,例如 CustomAuthStateProvider 注入 IJSRuntime 用于读取 localStorage 中的 token 在 GetAuthenticationStateAsync() 中解析 token(可用 System.IdentityModel.Tokens.Jwt 解码,或简单检查是否存在)并构造 ClaimsPrincipal 暴露一个 MarkUserAsAuthenticated(string token) 方法,保存 token 并通知状态变更 暴露一个 Logout() 方法,清除 token 并通知未登录状态
注意:WebAssembly 中无法直接访问 HttpContext,所以不能依赖服务端 Session;token 过期校验建议在每次请求前由 HttpClient 拦截器处理,而非全靠 Provider。
触发状态更新的正确方式
别在登录成功后只改内部字段就完事——UI 不会响应。必须调用 NotifyAuthenticationStateChanged。
常见错误写法:
❌ this._currentUser = new ClaimsPrincipal(identity); // 不会刷新 UI
正确做法:
构造新的 AuthenticationState 实例(含新 ClaimsPrincipal) 调用 NotifyAuthenticationStateChanged(Task.FromResult(new AuthenticationState(principal))) 如果操作是异步的(如从 API 获取用户信息),可直接返回该异步 Task
与路由和组件配合使用
确保 App.razor 中已包裹 CascadingAuthenticationState:
Not foundSorry, there's nothing at this address.
之后你就能在任意组件中使用:
... 根据角色/策略切换内容 @attribute [Authorize] 控制页面访问权限 @inject AuthenticationStateProvider AuthStateProvider 手动获取当前状态(不推荐频繁调用,优先用 AuthorizeView)
基本上就这些。不复杂但容易忽略 Notify 通知和生命周期注册时机,踩坑多在这两处。
以上就是Blazor AuthenticationStateProvider 使用教程的详细内容,更多请关注创想鸟其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1443060.html
微信扫一扫
支付宝扫一扫