当前位置:首页 > 文章列表 > 文章 > java教程 > JWT认证实现:Token生成与验证详解

JWT认证实现:Token生成与验证详解

2025-07-16 11:25:24 0浏览 收藏

在文章实战开发的过程中,我们经常会遇到一些这样那样的问题,然后要卡好半天,等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《Java实现JWT认证:Token生成与验证全解析》,聊聊,希望可以帮助到正在努力赚钱的你。

JWT在Java项目中用于无状态认证,实现流程包括生成Token和验证Token。1. 引入jjwt依赖库;2. 使用Jwts.builder()生成Token并设置签名算法、有效期等;3. 通过Jwts.parser()解析Token并处理异常;4. 在Spring Boot中登录后返回Token,拦截请求Header中的Token进行验证,解析后将用户信息放入Security上下文中,确保安全性与扩展性需关注签名强度、刷新机制及黑名单管理。

Java如何实现JWT认证?Token生成验证全流程

JWT(JSON Web Token)在Java项目中常用于无状态的认证机制。它的核心是通过签名保证数据的安全性,并且不依赖服务器保存会话信息,适合分布式系统使用。

Java如何实现JWT认证?Token生成验证全流程

实现JWT认证主要分为两部分:生成Token和验证Token。下面从实际开发角度出发,分几个关键步骤来说明如何用Java完成整个流程。


1. 引入依赖库

Java生态中有多个支持JWT的库,最常用的是 jjwtauth0-java-jwt。这里以 jjwt 为例,因为它封装得比较好,API也更简洁。

Java如何实现JWT认证?Token生成验证全流程

如果你用 Maven 管理项目,添加如下依赖:

<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-api</artifactId>
    <version>0.11.5</version>
</dependency>
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-impl</artifactId>
    <version>0.11.5</version>
</dependency>
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-jackson</artifactId>
    <version>0.11.5</version>
</dependency>

Gradle 用户可以这样加:

Java如何实现JWT认证?Token生成验证全流程
implementation 'io.jsonwebtoken:jjwt-api:0.11.5'
implementation 'io.jsonwebtoken:jjwt-impl:0.11.5'
implementation 'io.jsonwebtoken:jjwt-jackson:0.11.5'

2. 生成 JWT Token

生成 Token 的过程包括设置签发者、过期时间、负载内容以及签名算法等。

一个典型的生成方法如下:

import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.SignatureAlgorithm;
import java.util.Date;

public class JwtUtil {

    private static final String SECRET_KEY = "your-secret-key";
    private static final long EXPIRATION = 86400000; // 24小时

    public static String generateToken(String username) {
        return Jwts.builder()
                .setSubject(username)
                .setExpiration(new Date(System.currentTimeMillis() + EXPIRATION))
                .signWith(SignatureAlgorithm.HS512, SECRET_KEY)
                .compact();
    }
}

几点说明:

  • SECRET_KEY 是签名密钥,一定要保密,建议配置在环境变量或配置中心。
  • EXPIRATION 表示Token的有效期,可以根据业务需求调整。
  • 使用了 HS512 算法进行签名,也可以换成其他如 RS256,但需要配合非对称密钥使用。

3. 验证并解析 Token

验证Token的过程就是检查签名是否合法、是否过期,同时提取出其中的信息。

示例代码如下:

public static String parseToken(String token) {
    return Jwts.parser()
            .setSigningKey(SECRET_KEY)
            .parseClaimsJws(token)
            .getBody()
            .getSubject();
}

这个方法会返回Token中的用户名(subject),如果Token无效(比如被篡改或已过期),会抛出异常,因此调用时需要捕获处理。

常见错误类型包括:

  • JwtException:所有JWT异常的基类
  • JwtExpiredException:Token已过期
  • SignatureException:签名不匹配

所以在拦截器或过滤器中使用时,要合理捕获这些异常并返回合适的HTTP响应码。


4. 在Spring Boot中集成JWT

如果你是在Spring Boot项目中使用JWT,通常会在登录接口生成Token,并通过拦截器验证请求头中的Token。

大致流程如下:

  • 用户登录成功后,返回生成的Token;
  • 前端后续请求在Header中携带该Token;
  • 拦截器读取Header中的Token并验证;
  • 验证通过则放行,否则返回401未授权。

实现要点:

  • 自定义一个Filter继承 OncePerRequestFilter
  • doFilterInternal 方法中获取Token并解析
  • 将用户信息放入Security上下文中(可选)

这部分涉及到Spring Security的知识,可以根据项目实际情况灵活调整。


基本上就这些。JWT本身结构简单,但在实际应用中需要注意安全性和扩展性,比如签名强度、Token刷新机制、黑名单管理等。这些细节容易忽略,但在生产环境中不可忽视。

以上就是《JWT认证实现:Token生成与验证详解》的详细内容,更多关于的资料请关注golang学习网公众号!

PHP连接SQLServer导出数据详解PHP连接SQLServer导出数据详解
上一篇
PHP连接SQLServer导出数据详解
Golang优化K8s控制器,client-go缓存详解
下一篇
Golang优化K8s控制器,client-go缓存详解
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    542次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    511次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    498次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    484次学习
查看更多
AI推荐
  • TextIn智能文字识别:高效文档处理,助力企业数字化转型
    TextIn智能文字识别平台
    TextIn智能文字识别平台,提供OCR、文档解析及NLP技术,实现文档采集、分类、信息抽取及智能审核全流程自动化。降低90%人工审核成本,提升企业效率。
    7次使用
  • SEO  简篇 AI 排版:3 秒生成精美文章,告别排版烦恼
    简篇AI排版
    SEO 简篇 AI 排版,一款强大的 AI 图文排版工具,3 秒生成专业文章。智能排版、AI 对话优化,支持工作汇报、家校通知等数百场景。会员畅享海量素材、专属客服,多格式导出,一键分享。
    7次使用
  • SEO  小墨鹰 AI 快排:公众号图文排版神器,30 秒搞定精美排版
    小墨鹰AI快排
    SEO 小墨鹰 AI 快排,新媒体运营必备!30 秒自动完成公众号图文排版,更有 AI 写作助手、图片去水印等功能。海量素材模板,一键秒刷,提升运营效率!
    8次使用
  • AI Fooler:免费在线AI音频处理,人声分离/伴奏提取神器
    Aifooler
    AI Fooler是一款免费在线AI音频处理工具,无需注册安装,即可快速实现人声分离、伴奏提取。适用于音乐编辑、视频制作、练唱素材等场景,提升音频创作效率。
    7次使用
  • 易我人声分离:AI智能音频处理,一键分离人声与背景音乐
    易我人声分离
    告别传统音频处理的繁琐!易我人声分离,基于深度学习的AI工具,轻松分离人声和背景音乐,支持在线使用,无需安装,简单三步,高效便捷。
    8次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议隐私政策
返回登录
  • 重置密码