Blazor AuthenticationStateProvider 使用教程_石家庄创泽智能科技有限公司

新闻中心 NEWS CENTER

您当前位置：首页 > 新闻中心 > 网络学院

Blazor AuthenticationStateProvider 使用教程

2025-12-15

浏览次数：次

返回列表

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

blazor authenticationstateprovider 使用教程

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。

芦笋演示

一键出成片的录屏演示软件，专为制作产品演示、教学课程和使用教程而设计。

237 查看详情芦笋演示

常见错误写法：

❌ this._currentUser = new ClaimsPrincipal(identity); // 不会刷新 UI

正确做法：

构造新的 AuthenticationState 实例（含新 ClaimsPrincipal）
调用 NotifyAuthenticationStateChanged(Task.FromResult(new AuthenticationState(principal)))
如果操作是异步的（如从 API 获取用户信息），可直接返回该异步 Task

与路由和组件配合使用

确保 App.razor 中已包裹 CascadingAuthenticationState：

<CascadingAuthenticationState>
  <Router AppAssembly="@typeof(App).Assembly">
    <Found Context="routeData">
      <AuthorizeRouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)" />
      <FocusOnN*igate 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>

之后你就能在任意组件中使用：

<authorizeview>...</authorizeview> 根据角色/策略切换内容
@attribute [Authorize] 控制页面访问权限
@inject AuthenticationStateProvider AuthStateProvider 手动获取当前状态（不推荐频繁调用，优先用 AuthorizeView）

基本上就这些。不复杂但容易忽略 Notify 通知和生命周期注册时机，踩坑多在这两处。

以上就是Blazor AuthenticationStateProvider 使用教程的详细内容，更多请关注其它相关文章！

# 你就 # 南京网站建设优化企业 # 网站推广热销易速达 # 鄂州农产品网站建设公司 # 网站建设要求有哪些内容 # 广西抖音推广营销公司 # 抖音seo推广教程 # 谷歌推广和seo 快速推广 # 长安区企业网站推广价钱 # 龙岗网站建设服务提供商 # 宁夏seo快排技巧 # 相关文章 # 适用于 # 如何在 # 在这 # js # 序列化 # 操作指南 # 如何将 # 重写 # 自定义 # gate # 路由 # ai # session # 工具 # app # 浏览器 # cad # go