<!-- SpringBoot3 Web依賴（基礎(chǔ)必備） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- Sa-Token SpringBoot3 starter（核心依賴，適配SpringBoot3） -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-spring-boot3-starter</artifactId>
    <version>1.44.0</version>
</dependency>
<!-- Sa-Token 整合Redis（分布式部署必備，單機(jī)可省略，但建議加上） -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-spring-boot3-starter</artifactId>
    <version>1.44.0</version>
</dependency>
<!-- Redis依賴（SpringBoot3默認(rèn)適配） -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>
<!-- 工具類依賴（簡化代碼，可選但推薦） -->
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.28</version>
</dependency>

server:
  port: 8080 # 項目端口，可自定義
# Spring Redis配置（分布式部署必備，單機(jī)可省略但建議配置）
spring:
  redis:
    host: 127.0.0.1 # Redis地址，本地默認(rèn)127.0.0.1
    port: 6379 # Redis端口，默認(rèn)6379
    password: 123456 # 你的Redis密碼，沒有則留空
    database: 0 # Redis數(shù)據(jù)庫索引，默認(rèn)0
    timeout: 10000ms # 連接超時時間
# Sa-Token核心配置（重點，雙Token相關(guān)配置）
sa-token:
  # 1. 基礎(chǔ)配置
  token-name: satoken # Token在請求頭中的名稱（默認(rèn)satoken，可自定義，比如Authorization）
  token-style: uuid # Token生成風(fēng)格（uuid更安全，可選：uuid、simple-uuid、random-32等）
  is-concurrent: true # 是否允許同一賬號多地同時登錄（true允許，false新登錄擠掉舊登錄）
  # 2. 雙Token配置（核心中的核心）
  access-token-timeout: 1800 # AccessToken有效期，單位：秒（30分鐘，可自定義）
  refresh-token-timeout: 604800 # RefreshToken有效期，單位：秒（7天，可自定義）
  refresh-token-single: true # 是否同一賬號只生成一個RefreshToken（true更安全，避免多刷新令牌泄露）
  # 3. Redis配置（整合Redis，分布式部署必備）
  redis-model: standalone # Redis模式（單機(jī)：standalone，集群：cluster，哨兵：sentinel）
  redis-host: ${spring.redis.host} # 復(fù)用Spring Redis配置，不用重復(fù)寫
  redis-port: ${spring.redis.port}
  redis-password: ${spring.redis.password}
  redis-database: ${spring.redis.database}
  # 4. 異常配置（可選，自定義異常提示，更友好）
  not-login-message: 請先登錄！
  token-expire-message: 訪問令牌已過期，請刷新令牌！
  refresh-token-expire-message: 刷新令牌已過期，請重新登錄！

package com.example.doubleToken.entity;
import lombok.Data;
/**
 * 用戶實體類（對應(yīng)數(shù)據(jù)庫用戶表）
 * 實際項目中可根據(jù)需求擴(kuò)展字段，比如手機(jī)號、郵箱、角色等
 */
@Data
public class User {
    /**
     * 用戶ID（主鍵）
     */
    private Long id;
    /**
     * 用戶名（登錄賬號）
     */
    private String username;
    /**
     * 密碼（數(shù)據(jù)庫中建議加密存儲，比如用BCrypt加密）
     */
    private String password;
    /**
     * 用戶名（展示用，可選）
     */
    private String nickname;
}

package com.example.doubleToken.controller;
import cn.dev33.satoken.stp.StpUtil;
import cn.dev33.satoken.util.SaResult;
import com.example.doubleToken.entity.User;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.HashMap;
import java.util.Map;
/**
 * 登錄相關(guān)接口（核心：生成雙Token）
 */
@RestController
@RequestMapping("/auth")
public class AuthController {
    /**
     * 用戶登錄（生成雙Token）
     * @param user 登錄參數(shù)（username + password）
     * @return 雙Token + 用戶信息
     */
    @PostMapping("/login")
    public SaResult login(@RequestBody User user) {
        // 1. 校驗用戶名密碼（實際項目中，這里要從數(shù)據(jù)庫查詢用戶，比對密碼，建議加密比對）
        // 這里模擬校驗，實際項目中替換為自己的業(yè)務(wù)邏輯
        if (!"admin".equals(user.getUsername()) || !"123456".equals(user.getPassword())) {
            return SaResult.error("用戶名或密碼錯誤");
        }
        // 2. 生成雙Token（核心代碼，Sa-Token原生支持）
        // 參數(shù)1：用戶ID（唯一標(biāo)識，建議用數(shù)據(jù)庫主鍵）
        // 參數(shù)2：登錄設(shè)備類型（可選，比如pc、app、wechat，用于同端互斥登錄）
        StpUtil.login(user.getId(), "pc");
        // 3. 獲取生成的雙Token（返回給前端，前端保存）
        String accessToken = StpUtil.getTokenValue(); // AccessToken
        String refreshToken = SaTempUtil.createToken(user.getId(), 2592000);
        // 4. 組裝返回結(jié)果（返回Token + 用戶信息，前端按需保存）
        Map<String, Object> data = new HashMap<>();
        data.put("accessToken", accessToken);
        data.put("refreshToken", refreshToken);
        data.put("tokenType", "Bearer"); // 規(guī)范寫法，前端請求時拼接在Token前
        data.put("expiresIn", StpUtil.getTokenTimeout()); // AccessToken剩余有效期（秒）
        data.put("user", user); // 用戶信息，實際項目中可返回脫敏后的信息
        return SaResult.ok("登錄成功").setData(data);
    }
}

package com.example.doubleToken.config;
import cn.dev33.satoken.interceptor.SaInterceptor;
import cn.dev33.satoken.stp.StpUtil;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
/**
 * Sa-Token全局?jǐn)r截器配置（校驗Token，未登錄/Token過期攔截）
 */
@Configuration
public class SaTokenConfig implements WebMvcConfigurer {
    /**
     * 注冊Sa-Token攔截器
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 注冊全局?jǐn)r截器，攔截所有接口
        registry.addInterceptor(new SaInterceptor(handle -> {
            // 校驗AccessToken是否有效（核心校驗邏輯，一行代碼搞定）
            StpUtil.checkLogin();
            // 可選：校驗Token的設(shè)備類型（防止不同設(shè)備混用Token，提升安全性）
            // StpUtil.checkLoginType("pc");
        }))
        // 攔截所有接口
        .addPathPatterns("/**")
        // 排除不需要攔截的接口（登錄、刷新Token、登出接口，必須排除）
        .excludePathPatterns(
                "/auth/login",
                "/auth/refreshToken",
                "/auth/logout"
        );
    }
}

package com.example.doubleToken.controller;
import cn.dev33.satoken.stp.StpUtil;
import cn.dev33.satoken.util.SaResult;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import java.util.HashMap;
import java.util.Map;
/**
 * 刷新Token接口（核心：AccessToken過期后，用RefreshToken續(xù)期）
 */
@RestController
@RequestMapping("/auth")
public class RefreshTokenController {
    /**
     * 刷新AccessToken
     * @param refreshToken 前端傳入的RefreshToken
     * @return 新的AccessToken
     */
    @PostMapping("/refreshToken")
    public SaResult refreshToken(@RequestParam String refreshToken) {
        try {
            // 1、驗證
            Object userId = SaTempUtil.parseToken(refreshToken);
            if(userId == null) {
                return SaResult.error("無效 refreshToken");
            }
            // 2、為其生成新的短 token
            String accessToken = StpUtil.createLoginSession(userId);
            // 3、返回
            return SaResult.data(accessToken);
        } catch (Exception e) {
            // 異常說明：RefreshToken過期、無效，都會進(jìn)入這里，提示用戶重新登錄
            return SaResult.error("刷新Token失敗，請重新登錄").setCode(401);
        }
    }
}

package com.example.doubleToken.controller;
import cn.dev33.satoken.stp.StpUtil;
import cn.dev33.satoken.util.SaResult;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
/**
 * 登出接口（核心：銷毀雙Token）
 */
@RestController
@RequestMapping("/auth")
public class LogoutController {
    /**
     * 用戶登出（銷毀雙Token）
     * @return 登出結(jié)果
     */
    @PostMapping("/logout")
    public SaResult logout() {
        // 核心代碼：一鍵銷毀當(dāng)前用戶的AccessToken和RefreshToken
        // 會自動刪除Redis中的Token信息，解除用戶與Token的關(guān)聯(lián)
        StpUtil.logout();
        return SaResult.ok("登出成功");
    }
}

package com.example.doubleToken.controller;
import cn.dev33.satoken.stp.StpUtil;
import cn.dev33.satoken.util.SaResult;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
/**
 * 測試接口（驗證Token校驗是否生效）
 */
@RestController
@RequestMapping("/test")
public class TestController {
    /**
     * 測試接口（需要登錄才能訪問）
     * @return 測試結(jié)果
     */
    @GetMapping("/hello")
    public SaResult hello() {
        // 獲取當(dāng)前登錄用戶ID（登錄后才能獲取，未登錄會被攔截）
        Long userId = StpUtil.getLoginIdAsLong();
        return SaResult.ok("訪問成功").setData("當(dāng)前登錄用戶ID：" + userId);
    }
}