Spring Boot整合JWT實現(xiàn)認證與授權的項目實踐

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

JWT是開放標準,用于在Web應用中安全傳輸信息,常用于身份驗證和信息交換,本文主要介紹了SpringBoot整合JWT實現(xiàn)認證與授權,具有一定的參考價值,感興趣的可以了解一下

概述

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

依賴配置

首先需要在項目中添加JWT依賴：

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

JWT工具類封裝

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

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小時

    // 生成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();
    }

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

JWT攔截器實現(xiàn)

創(chuà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請求
        if ("OPTIONS".equals(request.getMethod())) {
            return true;
        }

        // 從請求頭獲取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配置

配置攔截器并設置攔截路徑：

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"
                );
    }
}

使用示例

登錄時生成令牌

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

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

基礎控制器

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

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

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

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

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

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

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