快捷導(dǎo)航

Spring Boot整合JWT實(shí)現(xiàn)認(rèn)證與授權(quán)的項(xiàng)目實(shí)踐

更新時(shí)間：2025年06月29日 11:36:00 作者：木子空間Pro

JWT是開(kāi)放標(biāo)準(zhǔn),用于在Web應(yīng)用中安全傳輸信息,常用于身份驗(yàn)證和信息交換,本文主要介紹了SpringBoot整合JWT實(shí)現(xiàn)認(rèn)證與授權(quán),具有一定的參考價(jià)值,感興趣的可以了解一下

概述

JSON Web Token (JWT) 是一種開(kāi)放標(biāo)準(zhǔn) (RFC 7519)，它定義了一種緊湊且自包含的方式，用于在各方之間安全地傳輸信息。在Web應(yīng)用中，JWT常用于身份驗(yàn)證和信息交換。

依賴配置

首先需要在項(xiàng)目中添加JWT依賴：

<!-- JWT依賴 -->
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt</artifactId>
    <version>0.9.1</version>
</dependency>

JWT工具類封裝

我們創(chuàng)建一個(gè)JwtUtil工具類來(lái)封裝JWT的生成、解析和驗(yàn)證邏輯：

package com.bookstore.utils;

import io.jsonwebtoken.Claims;
import io.jsonwebtoken.Jwts;
import io.jsonwebtoken.SignatureAlgorithm;
import org.springframework.stereotype.Component;

import java.util.Date;
import java.util.HashMap;
import java.util.Map;

@Component
public class JwtUtil {
    private static final String SECRET_KEY = "bookstore_secret_key";
    private static final long EXPIRATION_TIME = 24 * 60 * 60 * 1000; // 24小時(shí)

    // 生成JWT令牌
    public String generateToken(Integer userId, String role) {
        Map<String, Object> claims = new HashMap<>();
        claims.put("userId", userId);
        claims.put("role", role);
        
        return Jwts.builder()
                .setClaims(claims)
                .setIssuedAt(new Date())
                .setExpiration(new Date(System.currentTimeMillis() + EXPIRATION_TIME))
                .signWith(SignatureAlgorithm.HS256, SECRET_KEY)
                .compact();
    }

    // 解析JWT令牌
    public Claims parseToken(String token) {
        return Jwts.parser()
                .setSigningKey(SECRET_KEY)
                .parseClaimsJws(token)
                .getBody();
    }

    // 驗(yàn)證JWT令牌
    public boolean validateToken(String token) {
        try {
            Jwts.parser().setSigningKey(SECRET_KEY).parseClaimsJws(token);
            return true;
        } catch (Exception e) {
            return false;
        }
    }
}

JWT攔截器實(shí)現(xiàn)

創(chuàng)建攔截器來(lái)驗(yàn)證請(qǐng)求中的JWT令牌：

package com.bookstore.config;

import com.bookstore.utils.JwtUtil;
import io.jsonwebtoken.Claims;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

@Component
public class JwtInterceptor implements HandlerInterceptor {

    @Autowired
    private JwtUtil jwtUtil;

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // 放行OPTIONS請(qǐng)求
        if ("OPTIONS".equals(request.getMethod())) {
            return true;
        }

        // 從請(qǐng)求頭獲取token
        String token = request.getHeader("Authorization");
        if (token != null && token.startsWith("Bearer ")) {
            token = token.substring(7);
            if (jwtUtil.validateToken(token)) {
                Claims claims = jwtUtil.parseToken(token);
                // 將用戶信息存入request屬性中
                request.setAttribute("userId", claims.get("userId"));
                request.setAttribute("role", claims.get("role"));
                return true;
            }
        }
        
        response.setStatus(401);
        return false;
    }
}

MVC配置

配置攔截器并設(shè)置攔截路徑：

package com.bookstore.config;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Autowired
    private JwtInterceptor jwtInterceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(jwtInterceptor)
                .addPathPatterns("/**")  // 攔截所有路徑
                .excludePathPatterns(    // 排除路徑
                        "/login",
                        "/register",
                        "/swagger-resources/**",
                        "/webjars/**",
                        "/v3/api-docs/**",
                        "/swagger-ui.html/**",
                        "/error",
                        "/favicon.ico",
                        "doc.html",
                        "/logout",
                        "/static/**",
                        "/carousel/list",
                        "/book/new",
                        "/v2/api-docs"
                );
    }
}

使用示例

登錄時(shí)生成令牌

在登錄成功后生成JWT令牌并返回給客戶端：

String token = jwtUtil.generateToken(foundUser.getId(), foundUser.getRole());

基礎(chǔ)控制器

創(chuàng)建基礎(chǔ)控制器方便獲取已認(rèn)證的用戶信息：

import javax.servlet.http.HttpServletRequest;
import org.springframework.beans.factory.annotation.Autowired;

public class BaseController {
    @Autowired
    protected HttpServletRequest request;
    
    // 獲取當(dāng)前用戶ID
    protected Integer getCurrentUserId() {
        return (Integer) request.getAttribute("userId");
    }
    
    // 獲取當(dāng)前用戶角色
    protected String getCurrentUserRole() {
        return (String) request.getAttribute("role");
    }

    // 檢查是否是管理員
    protected boolean isAdmin() {
        return "admin".equals(getCurrentUserRole());
    }

    // 檢查是否是普通用戶
    protected boolean isUser() {
        return "user".equals(getCurrentUserRole());
    }
}

其他控制器可以繼承BaseController來(lái)方便地獲取用戶信息：

@RestController
@RequestMapping("/api/books")
public class BookController extends BaseController {
    
    @GetMapping("/{id}")
    public ResponseEntity<Book> getBook(@PathVariable Integer id) {
        if (isAdmin()) {
            // 管理員特有邏輯
        }
        // 其他邏輯...
    }
}

總結(jié)

JWT工具類：封裝了令牌的生成、解析和驗(yàn)證邏輯
攔截器：自動(dòng)驗(yàn)證請(qǐng)求中的JWT令牌并提取用戶信息
MVC配置：靈活配置需要攔截和放行的路徑
基礎(chǔ)控制器：提供便捷的方法獲取當(dāng)前用戶信息

這種實(shí)現(xiàn)方式具有以下優(yōu)點(diǎn)：

無(wú)狀態(tài)認(rèn)證，服務(wù)端不需要存儲(chǔ)會(huì)話信息
跨域支持良好
可以方便地?cái)y帶用戶信息
適合分布式系統(tǒng)

在實(shí)際項(xiàng)目中，可以根據(jù)需求調(diào)整令牌的有效期、密鑰的存儲(chǔ)方式（如從配置中心獲取）以及更精細(xì)的權(quán)限控制邏輯。

到此這篇關(guān)于Spring Boot整合JWT實(shí)現(xiàn)認(rèn)證與授權(quán)的項(xiàng)目實(shí)踐的文章就介紹到這了,更多相關(guān)Spring Boot JWT認(rèn)證與授權(quán)內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: