SpringBoot权限认证-Sa-Token的使用与详解

本文详细介绍了Sa-Token在Java项目中的使用方法，包括Sa-Token的基本概念、与其他权限框架的比较、基本语法和高级用法，并通过实例讲解了如何在项目中集成和使用Sa-Token。作为一款轻量级Java权限认证框架，Sa-Token在简化权限管理、提高开发效率方面发挥了重要作用。本文还将深入探讨Sa-Token的核心原理，通过内部代码展示其工作机制。最后，总结了Sa-Token的优缺点及其在实际开发中的应用场景，为开发者提供全面的指导。

---

一、Sa-Token介绍

1. Sa-Token简介

Sa-Token是一款轻量级Java权限认证框架，旨在解决Web系统中常见的登录认证、权限验证、Session会话、单点登录等问题。其核心目标是以最简洁的方式，实现强大的权限控制功能，帮助开发者快速完成权限系统的搭建。

Sa-Token具有如下优势：

优势	描述
简单易用	API设计简洁明了，易于集成和使用，上手快，学习成本低。
功能丰富	支持多种权限控制需求，满足复杂业务场景。支持登录认证、权限验证、角色验证、Session会话、多账号体系等功能。
高性能	轻量级设计，对系统性能影响小。
高度可扩展	提供丰富的扩展接口，与Spring、Spring Boot等常用框架高度兼容，支持自定义持久化、注解方式验证、单点登录等高级特性。
社区活跃	有良好的社区支持和文档资源。

2. Sa-Token原理解析

Sa-Token的核心原理是通过Token机制实现用户的身份认证和权限校验。

其主要工作流程如下：

① 登录认证：用户登录成功后，服务器生成一个全局唯一的Token，并将其返回给客户端。 ② Token存储：Token与用户身份信息的映射关系保存在服务器的会话中(如Redis、内存等)。 ③ 权限验证：客户端请求时携带Token，服务器根据Token获取用户信息，验证其权限是否满足要求。 ④ 会话管理：支持Session会话管理，可以获取和操作当前会话的属性。

流程图例如下：

3. Sa-Token与其他权限框架比较

Sa-Token与其他常见权限框架在学习成本、集成难度上有显著优势：

特性	Sa-Token	Shiro	Spring Security
学习成本	低	中	高
功能丰富度	高	中	高
集成难度	低	中	高
性能表现	高	中	中
社区支持	活跃	一般	活跃
扩展性	高	中	高

---

二、Sa-Token的基本语法

在实际项目中，Sa-Token通过简单的配置和API调用，即可实现完整的权限管理功能。以下将通过一个完整的Spring Boot示例，演示如何集成和使用Sa-Token。

1. 创建Spring Boot项目

首先，创建一个新的Spring Boot项目，可以使用IDEA的项目向导或Spring Initializr。

引入必要的依赖：

登录后复制

<dependencies>
    <!-- Spring Boot Starter Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Sa-Token核心依赖 -->
    <dependency>
        <groupId>cn.dev33</groupId>
        <artifactId>sa-token-spring-boot-starter</artifactId>
        <version>1.34.0</version>
    </dependency>
</dependencies>

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.
• 8.
• 9.
• 10.
• 11.
• 12.
• 13.
• 14.

2. 配置Sa-Token

application.yml

登录后复制

# Sa-Token配置，可根据需要进行调整
sa-token:
  # token有效期，单位秒，默认30天
  timeout: 2592000

  # 是否打开二级登录校验
  open-safe: false

• 1.
• 2.
• 3.
• 4.
• 5.
• 6.
• 7.

3. 配置拦截器

创建配置类，添加Sa-Token的拦截器，以拦截请求并进行权限验证。

SaTokenConfigure.java

登录后复制

import cn.dev33.satoken.interceptor.SaAnnotationInterceptor;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.*;

@Configuration
public class SaTokenConfigure implements WebMvcConfigurer {
          
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
          
        // 注册Sa-Token的注解拦截器，拦截所有路径
        registry.addInterceptor(new SaAnnotationInterceptor()).addPathPatterns("/**");