明明接了 Redis，重启后会话还是丢了？

程序员NEO

发布于 2026-04-29 19:37:03

1150

你有没有遇到过这种情况：本地调试都正常，一上测试环境，两台服务的登录态就开始“各管各的”。我第一次碰到时，最离谱的是服务重启后，用户直接被批量踢下线。这篇文章不讲空话，就按我真实落地顺序，把 Sa-Token 集成 Redis 的关键点和坑一次说透。

先把问题讲透：为什么默认内存模式会出事

Sa-Token 默认把数据放内存，这个设计本身没问题。它的优点很实在：快，而且没有序列化/反序列化损耗。

但到了真实工程环境，两个问题会非常致命：

1. 服务重启后数据会丢失。
2. 分布式节点之间无法共享会话数据。

所以你会看到一个很典型的现象：

• 单机开发阶段，体验很好。
• 一旦多实例部署，登录态开始“随机异常”。

我后来把会话层切到 Redis，本质上就是把会话从“进程内状态”变成“共享状态”。这一步做完，重启丢失和多节点不一致才算真正收敛。

第一步：先用最稳的 RedisTemplate 方案

如果你只想快速落地，不想折腾太多实现细节，直接上官方推荐方案就行。

Maven

<!-- Sa-Token 整合 RedisTemplate -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-redis-template</artifactId>
    <version>${sa.top.version}</version>
</dependency>

<!-- 提供 Redis 连接池 -->
<dependency>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-pool2</artifactId>
</dependency>

Gradle

// Sa-Token 整合 RedisTemplate
implementation 'cn.dev33:sa-token-redis-template:${sa.top.version}'

// 提供 Redis 连接池
implementation 'org.apache.commons:commons-pool2'

这块我个人建议是：先跑通，再优化。别一上来就追求“最优序列化格式”，先把会话一致性问题解决掉。

第二步：确认 Redis 真连上了（这一步最容易漏）

我踩过的坑是：依赖加了，但环境变量没配全。结果项目看起来启动正常，实际会话并没有落到 Redis。

spring: 
    # redis配置 
    redis:
        # Redis数据库索引（默认为0）
        database: 1
        # Redis服务器地址
        host: 127.0.0.1
        # Redis服务器连接端口
        port: 6379
        # Redis服务器连接密码（默认为空）
        # password: 
        # 连接超时时间
        timeout: 10s
        lettuce:
            pool:
                # 连接池最大连接数
                max-active: 200
                # 连接池最大阻塞等待时间（使用负值表示没有限制）
                max-wait: -1ms
                # 连接池中的最大空闲连接
                max-idle: 10
                # 连接池中的最小空闲连接
                min-idle: 0

# Redis数据库索引（默认为0）
spring.redis.database=1
# Redis服务器地址
spring.redis.host=127.0.0.1
# Redis服务器连接端口
spring.redis.port=6379
# Redis服务器连接密码（默认为空）
# spring.redis.password=
# 连接超时时间
spring.redis.timeout=10s
# 连接池最大连接数
spring.redis.lettuce.pool.max-active=200
# 连接池最大阻塞等待时间（使用负值表示没有限制）
spring.redis.lettuce.pool.max-wait=-1ms
# 连接池中的最大空闲连接
spring.redis.lettuce.pool.max-idle=10
# 连接池中的最小空闲连接
spring.redis.lettuce.pool.min-idle=0

⚠️ 小提示：如果你是 SpringBoot3.x，前缀要从 spring.redis 改成 spring.data.redis。

第三步：理解序列化，不然排障会很痛苦

默认情况下，Redis 里看到的是 JSON 格式。这没什么问题，但你要知道它背后是两层序列化：

• String 序列化
• JSON 序列化

如果你需要换 JSON 框架，可以用这些依赖。

Fastjson

<!-- Sa-Token 整合 Fastjson -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-fastjson</artifactId>
    <version>${sa.top.version}</version>
</dependency>

Gradle 参考：implementation 'cn.dev33:sa-token-fastjson:${sa.top.version}'

Fastjson2

<!-- Sa-Token 整合 Fastjson2 -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-fastjson2</artifactId>
    <version>${sa.top.version}</version>
</dependency>

Gradle 参考：implementation 'cn.dev33:sa-token-fastjson2:${sa.top.version}'

Snack3

<!-- Sa-Token 整合 Snack3 -->
<dependency>
    <groupId>cn.dev33</groupId>
    <artifactId>sa-token-snack3</artifactId>
    <version>${sa.top.version}</version>
</dependency>

Gradle 参考：implementation 'cn.dev33:sa-token-snack3:${sa.top.version}'

第四步：不想走 JSON？直接改 String 序列化

这个场景我也遇到过。有些老系统有固定编码约束，不想引入 JSON 序列化，就直接切 String 层。

jdk序列化 (base64编码)

// 设置序列化方案: jdk序列化 (base64编码)
@PostConstruct
public void rewriteComponent() {
    SaManager.setSaSerializerTemplate(new SaSerializerTemplateForJdkUseBase64());
}

jdk序列化 (16进制编码)

// 设置序列化方案: jdk序列化 (16进制编码)
@PostConstruct
public void rewriteComponent() {
    SaManager.setSaSerializerTemplate(new SaSerializerTemplateForJdkUseHex());
}

jdk序列化 (ISO-8859-1编码)

// 设置序列化方案: jdk序列化 (ISO-8859-1编码)
@PostConstruct
public void rewriteComponent() {
    SaManager.setSaSerializerTemplate(new SaSerializerTemplateForJdkUseISO_8859_1());
}

💡 实战建议：