Blazor AuthenticationStateProvider 使用教程

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<authenticationstate></authenticationstate>，并通过 NotifyAuthenticationStateChanged 方法通知所有监听者状态已更新。

关键点：

• 必须注册为 Scoped（Blazor Server）或 Singleton（Blazor WebAssembly），且早于 AuthenticationStateProvider 的消费者（如 CascadingAuthenticationState）注册
• 重写 GetAuthenticationStateAsync() 返回当前状态（同步或异步获取用户信息）
• 调用 NotifyAuthenticationStateChanged(Task<authenticationstate>)</authenticationstate> 才能触发 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。

标签： js go cad 浏览器 app 工具 session ai 路由 gate