Sa-Token持久层扩展：从内存存储到Redis集成详解

丁柯新Fawn

于 2025-06-02 09:02:47 发布

阅读量290

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00286/article/details/148375147

Sa-Token持久层扩展：从内存存储到Redis集成详解

Sa-Token 一个轻量级 Java 权限认证框架，让鉴权变得简单、优雅！—— 登录认证、权限认证、分布式Session会话、微服务网关鉴权、单点登录、OAuth2.0 项目地址: https://gitcode.com/gh_mirrors/sa/Sa-Token

一、Sa-Token默认存储机制解析

Sa-Token框架默认采用内存存储(Memory)方式管理会话数据，这种设计具有两大显著优势：

极致性能：直接内存读写，无需序列化/反序列化过程
零配置开箱即用：开发者无需额外配置即可快速体验框架功能

但这种存储方式存在两个明显的局限性：

数据易失性：服务重启后所有会话数据将丢失
集群限制：无法在分布式环境中共享会话状态

二、Sa-Token持久化架构设计

Sa-Token采用抽象接口的设计模式，将数据持久化操作统一抽象到SaTokenDao接口中。这种架构设计体现了以下设计思想：

开闭原则：对扩展开放，对修改关闭
单一职责：数据存取与业务逻辑分离
接口隔离：定义清晰的存储契约

开发者可以通过实现该接口，将会话数据存储在任何符合业务需求的介质中。

三、Redis集成方案详解

3.1 JDK序列化方案

Maven依赖配置：

<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-redis</artifactId>
    <version>${sa.top.version}</version>
</dependency>

特点分析：

优点：兼容所有Java原生类型，稳定性高
缺点：二进制存储不可读，调试困难
适用场景：对数据可读性无要求的生产环境

3.2 Jackson序列化方案

Maven依赖配置：

<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-redis-jackson</artifactId>
    <version>${sa.top.version}</version>
</dependency>

特点分析：

优点：JSON格式可读性强，支持手动修改
缺点：对复杂对象类型支持有限
适用场景：需要调试会话数据的开发环境

四、Redis集成实践指南

4.1 必备依赖

两种Redis方案都需要以下基础支持：

<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-pool2</artifactId>
</dependency>

4.2 详细配置示例

spring:
  redis:
    database: 1                  # Redis逻辑数据库编号
    host: 127.0.0.1             # 服务地址
    port: 6379                  # 服务端口
    timeout: 1000ms             # 连接超时
    lettuce:                    # Lettuce连接池配置
      pool:
        max-active: 200         # 最大连接数
        max-wait: -1ms          # 最大等待时间(无限制)
        max-idle: 10            # 最大空闲连接
        min-idle: 0             # 最小空闲连接

关键参数说明：