Sa-Token 项目介绍-优快云博客

Sa-Token 项目介绍

【免费下载链接】Sa-Token 一个轻量级 java 权限认证框架，让鉴权变得简单、优雅！ —— 登录认证、权限认证、分布式Session会话、微服务网关鉴权、SSO 单点登录、OAuth2.0 统一认证项目地址: https://gitcode.com/dromara/sa-token

Sa-Token 是一个轻量级 Java 权限认证框架，专注于解决登录认证、权限认证、单点登录、OAuth2.0 和微服务鉴权等核心问题。它通过简洁的 API 设计和丰富的功能模块，帮助开发者快速构建安全、高效的权限管理系统。

Sa-Token 是什么

Sa-Token 是一个轻量级 Java 权限认证框架，专注于解决登录认证、权限认证、单点登录、OAuth2.0 和微服务鉴权等核心问题。它通过简洁的 API 设计和丰富的功能模块，帮助开发者快速构建安全、高效的权限管理系统。以下将从多个维度详细介绍 Sa-Token 的核心特性和设计理念。

核心特性

登录认证
Sa-Token 提供了灵活的登录认证机制，支持单端登录、多端登录、同端互斥登录等功能。通过一行代码即可完成会话登录：
```
StpUtil.login(10001); // 登录账号id为10001的用户
```

权限认证
支持基于角色和权限的细粒度控制，可通过注解或路由拦截实现权限校验：

@SaCheckPermission("user:add") // 只有具备user:add权限的用户才能访问此方法
public String addUser() {
    return "用户添加成功";
}

单点登录 (SSO)
Sa-Token 提供了三种 SSO 模式，适应不同架构需求：
- 模式一：同域 + 同 Redis，共享 Cookie 同步会话。
- 模式二：不同域 + 同 Redis，通过 URL 重定向传播会话。
- 模式三：不同域 + 不同 Redis，通过 HTTP 请求获取会话。
OAuth2.0 支持
支持授权码、隐藏式、密码式和客户端凭证四种授权模式，满足多样化的授权需求。
微服务鉴权
适配 Gateway、ShenYu、Zuul 等常见网关，提供分布式会话和 RPC 调用鉴权能力。

设计理念

简洁易用
Sa-Token 的 API 设计遵循“一行代码解决问题”的原则，例如踢人下线：
```
StpUtil.kickout(10077); // 将账号id为10077的用户踢下线
```
高性能
通过灵活的持久层扩展（如 Redis 集成）和高效的算法设计，确保框架在高并发场景下的性能表现。
模块化设计
核心功能模块化，开发者可按需引入，避免冗余依赖。例如：
- sa-token-core：核心模块。
- sa-token-spring-boot-starter：Spring Boot 集成模块。
- sa-token-jwt：JWT 支持模块。
多框架适配
不仅支持 Spring Boot，还适配 Solon、JFinal 等框架，真正做到开箱即用。

核心类解析

StpUtil
工具类，封装了登录、注销、权限校验等常用操作。例如：
```
StpUtil.checkLogin(); // 校验当前会话是否登录
```

SaTokenConfig
配置类，用于全局设置 Token 名称、过期时间、是否并发登录等参数。例如：

@Bean
public SaTokenConfig saTokenConfig() {
    SaTokenConfig config = new SaTokenConfig();
    config.setTokenName("satoken");
    config.setTimeout(86400); // Token有效期24小时
    return config;
}

StpInterface
接口类，开发者需实现其方法以自定义权限数据加载逻辑。例如：

@Component
public class StpInterfaceImpl implements StpInterface {
    @Override
    public List<String> getPermissionList(Object loginId, String loginType) {
        return Arrays.asList("user:add", "user:delete");
    }
}

技术对比

特性	Sa-Token	Shiro	Spring Security
学习曲线	低	中	高
功能丰富度	高	中	高
性能	高	中	低
多框架适配	支持	有限	仅Spring
社区活跃度	高	中	高

适用场景

快速开发：适合需要快速集成权限管理的项目。
微服务架构：提供分布式会话和鉴权支持。
多端登录：支持APP、Web、小程序等多端同时在线。

通过以上介绍，可以看出 Sa-Token 是一个功能强大、设计优雅的权限认证框架，能够显著提升开发效率并降低系统复杂度。

核心功能模块

Sa-Token 是一个轻量级 Java 权限认证框架，其核心功能模块设计简洁高效，覆盖了登录认证、权限认证、单点登录、OAuth2.0 和微服务鉴权等多个场景。以下是对其核心功能模块的详细解析：