Blazor HttpClient 附加 JWT Token 的方法

煙雲

发布时间：2025-12-14 21:37:18

606人浏览过

来源于php中文网

原创

最推荐的方式是使用自定义 DelegatingHandler（如 AuthorizationMessageHandler）配合 IJSRuntime 读取 localStorage 中的 JWT Token 并自动添加到 Authorization 请求头，再通过 Program.cs 正确注册命名 HttpClient 并注入该 handler，实现一次配置、全局生效。

blazor httpclient 附加 jwt token 的方法

在 Blazor（尤其是 Blazor WebAssembly）中，为 HttpClient 自动附加 JWT Token 最常用、最推荐的方式是使用 自定义 DelegatingHandler，配合 IJSRuntime 读取本地存储的 token（如 localStorage），再注入到每个请求的 Authorization 头中。

1. 创建带 Token 的 HttpClient Handler

新建一个继承自 DelegatingHandler 的类，例如 AuthorizationMessageHandler：

public class AuthorizationMessageHandler : DelegatingHandler
{
    private readonly IJSRuntime _jsRuntime;

    public AuthorizationMessageHandler(IJSRuntime jsRuntime)
    {
        _jsRuntime = jsRuntime;
    }

    protected override async Task SendAsync(
        HttpRequestMessage request, CancellationToken cancellationToken)
    {
        var token = await _jsRuntime.InvokeAsync("localStorage.getItem", "authToken");
        if (!string.IsNullOrEmpty(token))
        {
            request.Headers.Authorization = new AuthenticationHeaderValue("Bearer", token);
        }
        return await base.SendAsync(request, cancellationToken);
    }
}

这个 handler 会在每次 HTTP 请求发出前，从浏览器 localStorage 中读取 token 并添加到请求头。

2. 在 Program.cs 中注册并配置 HttpClient

在 Blazor WebAssembly 的 Program.cs 中，注册该 handler，并将其注入到命名的 HttpClient：

builder.Services.AddScoped();
builder.Services.AddHttpClient()
    .AddHttpMessageHandler()
    .ConfigureHttpClient(client =>
    {
        client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress);
    });

注意：不要直接注册无名的 HttpClient（如 AddHttpClient），否则可能干扰框架默认客户端；推荐为 API 服务创建专用接口+实现，或使用命名客户端。

造次

Liblib打造的AI原创IP视频创作社区

下载

3. Token 存储与刷新时机要匹配

确保 token 已正确存入 localStorage，且在登录成功后及时写入：

登录成功后调用 JS： await jsRuntime.InvokeVoidAsync("localStorage.setItem", "authToken", token);
登出时务必清除：await jsRuntime.InvokeVoidAsync("localStorage.removeItem", "authToken");
若 token 有过期时间，可在 AuthorizationMessageHandler 中加一层校验（比如解析 JWT payload 判断 exp），但更推荐由上层逻辑统一管理 token 刷新流程

4. 可选：支持多租户或动态 BaseAddress 场景

如果应用需对接多个 API 域名，可扩展 handler 构造函数，传入作用域标识或配置项，再按需决定是否附加 token 或附加到哪个请求：

通过 Named HttpClient 分离不同 API 客户端
在 handler 中检查 request.RequestUri.Host，只对特定域名附加 token
避免把敏感 token 泄露到不信任的第三方接口

基本上就这些。核心是 handler + localStorage + 正确注册顺序。不需要手动在每个 service 方法里加 header，也不依赖组件生命周期——真正做到了“一次配置，全局生效”。

Blazor 怎么集成 Ant Design Blazor

c# 如何执行 javascript 脚本

Blazorise 集成和配置教程

Blazor JS Interop 异步调用和回调处理

C# 如何在Blazor中调用JavaScript函数 - JS互操作(JS Interop)

相关标签:

js 浏览器 ai 作用域构造函数 Token 继承接口 JS 作用域 http

本站声明：本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系admin@php.cn

上一篇：Blazor 组件化 CSS 作用域隔离教程下一篇：Dapper如何处理SQL Server中的FileStream Dapper文件流数据操作

作者最新文章

宝书网直接进入入口宝书网免注册登录入口

2026-01-18 14:48

国家中小学智慧教育平台教师登录入口智慧教育官网备课平台入口

2026-01-18 15:05

全国医保异地就医结算平台官网入口国家医保服务平台个人登录

2026-01-18 15:08

支付宝花呗注销后还能恢复吗重新开通花呗服务的条件与操作流程【指南】

2026-01-18 15:33

2026年实测：抖音视频去水印保存到相册的最快方法【教程】

2026-01-18 15:41

Word逻辑判断变色怎么设置 Word邮件合并IF域条件格式【进阶】

2026-01-18 16:04

QQ浏览器怎么下载网页视频 QQ浏览器视频提取下载教程

2026-01-18 16:12

Word最后一行后面有空白页删不了？教你缩小段落间距

2026-01-18 16:57

Edge浏览器怎么安装谷歌插件 Edge兼容Chrome扩展程序设置

2026-01-18 20:09

Safari浏览器总是跳转app怎么办阻止Safari自动唤起APP设置

2026-01-18 20:12

热门AI工具

DeepSeek

幻方量化公司旗下的开源大模型平台

AI大模型

开放平台

豆包大模型

字节跳动自主研发的一系列大型语言模型

AI大模型

通义千问

阿里巴巴推出的全能AI助手

AI大模型

腾讯元宝

腾讯混元平台推出的AI助手

文档处理

Excel 表格

文心一言

文心一言是百度开发的AI聊天机器人，通过对话可以生成各种形式的内容。

AI大模型

中文写作

讯飞写作

基于讯飞星火大模型的AI写作工具，可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

中文写作

写作工具

即梦AI

一站式AI创作平台，免费AI图片和视频生成。

图片拼接

图画生成

ChatGPT

最最强大的AI聊天机器人程序，ChatGPT不单是聊天机器人，还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

AI大模型

中文写作

智谱清言 - 免费全能的AI助手

AI大模型

PDF 文档

相关专题

登录token无效

登录token无效解决方法：1、检查token的有效期限，如果token已经过期，需要重新获取一个新的token；2、检查token的签名，如果签名不正确，需要重新获取一个新的token；3、检查密钥的正确性，如果密钥不正确，需要重新获取一个新的token；4、使用HTTPS协议传输token，建议使用HTTPS协议进行传输；5、使用双因素认证，双因素认证可以提高账户的安全性。

6096

2023.09.14

登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容，供大家免费下载体验。

806

2023.09.14

token怎么获取

获取token值的方法：1、小程序调用“wx.login()”获取临时登录凭证code，并回传到开发者服务器；2、开发者服务器以code换取，用户唯一标识openid和会话密钥“session_key”。想了解更详细的内容，可以阅读本专题下面的文章。

1062

2023.12.21

token什么意思

token是一种用于表示用户权限、记录交易信息、支付虚拟货币的数字货币。可以用来在特定的网络上进行交易，用来购买或出售特定的虚拟货币，也可以用来支付特定的服务费用。想了解更多token什么意思的相关内容可以访问本专题下面的文章。

1251

2024.03.01

硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍：1、IDE接口是一种并行接口，主要用于连接硬盘和光驱等设备，它主要有两种类型：ATA和ATAPI，IDE接口已经逐渐被SATA接口；2、SATA接口是一种串行接口，相较于IDE接口，它具有更高的传输速度、更低的功耗和更小的体积；3、SCSI接口等等。

1023

2023.10.19