Spring Boot 整合 SA-Token 的使用详解

Spring Boot 整合 SA-Token 的使用详解涉及多个方面，包括SA-Token的介绍、整合步骤、配置方法、具体使用场景以及代码示例等。以下是一个详细的解析，旨在帮助读者全面理解和应用SA-Token在Spring Boot项目中的权限认证和登录认证功能。

一、SA-Token介绍

SA-Token是一个轻量级的Java权限认证框架，由国人开发，主要解决登录认证、权限认证、单点登录、OAuth2.0、分布式Session会话、微服务网关鉴权等一系列权限相关问题。SA-Token旨在以简单、优雅的方式完成系统的权限认证部分，其特点包括：

• 轻量级：SA-Token不依赖任何第三方框架，只依赖JDK原生API，易于学习和使用。
• 零配置：SA-Token提供了丰富的内置功能，用户可以通过简单的配置即可使用，无需编写大量的代码。
• 注解式鉴权：SA-Token提供了丰富的注解，如@SaCheckPermission、@SaCheckRole等，可以很方便地在Controller层进行权限控制。
• 丰富的会话管理：SA-Token支持多种会话管理方式，包括Account-Session、Token-Session、Custom-Session等，并提供了丰富的会话操作方法。

二、Spring Boot整合SA-Token的步骤

1. 引入SA-Token依赖

首先，你需要在Spring Boot项目的pom.xml文件中引入SA-Token的依赖。如果你使用的是Spring Boot 3.x版本，需要引入sa-token-spring-boot3-starter依赖；如果是Spring Boot 2.x版本，则引入sa-token-spring-boot-starter依赖。以Spring Boot 3.x为例，添加依赖如下：

<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-spring-boot3-starter</artifactId>
    <version>最新版本</version> <!-- 请替换为最新版本号 -->
</dependency>

2. 配置SA-Token

在application.yml或application.properties配置文件中，你可以根据需要配置SA-Token的相关参数。以下是一个配置示例：

sa-token:
  token-name: Authorization  # token名称 (header中key)
  token-type: bearer         # token类型 (header中value的前缀)
  timeout: 3600              # token过期时间, 单位秒
  activity-timeout: -1