问题：Spring Boot中Sa-Token存入Redis后过一段时间自动消失，可能是什么原因？

Question

在Spring Boot项目中集成Sa-Token并使用Redis作为持久化存储时，可能会遇到token在一段时间后自动失效的问题。常见的原因包括：Sa-Token的配置未正确设置持久化策略，导致token未被持久化到Redis；Redis自身的过期策略（如设置了TTL）导致数据被自动清除；或Sa-Token与Redis的序列化方式不一致，造成数据读取失败。此外，也可能是由于未正确调用`StpUtil.login()`或`StpUtil.getTokenTimeout()`方法，导致token生命周期管理异常。排查时应重点检查Sa-Token的Redis配置、序列化方式及token的生成与验证流程。

Answer 1

一、问题背景与常见现象

在Spring Boot项目中集成Sa-Token并使用Redis作为token的持久化存储时，开发者可能会遇到token在一段时间后自动失效的问题。这种问题通常表现为用户登录后，过一段时间再次访问接口时被强制要求重新登录。

常见的现象包括：

• token在Redis中存在但无法被识别；
• token在设定的过期时间前被清除；
• 调用StpUtil.getTokenValue()时返回null；
• 调用StpUtil.getLoginId()时报错或返回null。

二、可能原因分析

造成token自动失效的原因可能涉及多个层面，以下为常见原因分类：

分类	具体原因
Sa-Token配置问题	未正确配置持久化策略，未启用Redis插件
Redis配置问题	设置了TTL导致token被清除
序列化/反序列化问题	Sa-Token与Redis使用的序列化方式不一致
API调用问题	未正确调用StpUtil.login()或未设置token有效时间

三、排查流程与解决方案

为系统性地排查该问题，建议按照以下流程进行：

graph TD
    A[检查Sa-Token配置] --> B{是否启用Redis持久化}
    B -- 否 --> C[配置Sa-Token Redis插件]
    B -- 是 --> D[检查Redis配置]
    D --> E{是否设置TTL}
    E -- 是 --> F[调整TTL或设置永不过期]
    E -- 否 --> G[检查序列化方式]
    G --> H{是否一致}
    H -- 否 --> I[统一序列化格式]
    H -- 是 --> J[检查token生成逻辑]
    J --> K{是否调用login方法}
    K -- 否 --> L[正确调用StpUtil.login()]
    K -- 是 --> M[检查token验证流程]
    M --> N{是否调用getTokenTimeout}
    N -- 否 --> O[正确设置token过期时间]
    N -- 是 --> P[问题已解决]
    

四、关键配置与代码示例

以下为Sa-Token集成Redis的关键配置示例：

@Configuration
public class SaTokenConfig {

    @Bean
    public SaTokenDao getSaTokenDao() {
        return new SaTokenDaoRedis();
    }

    @Bean
    public SaTokenContext getSaTokenContext() {
        return new SaTokenContext();
    }
}
    

在Spring Boot的配置文件中添加Redis连接信息：

spring:
  redis:
    host: localhost
    port: 6379
sa-token:
  timeout: 86400 # token有效期（单位秒）
  is-concurrent: true
  is-share: true
    

五、进阶建议与最佳实践

为避免token自动失效问题，建议开发者遵循以下最佳实践：

1. 确保Sa-Token的Redis插件已正确引入；
2. 统一使用JSON格式进行序列化与反序列化；
3. 定期监控Redis中token的TTL与存储情况；
4. 在登录逻辑中明确调用StpUtil.login()方法；
5. 使用StpUtil.setTokenTimeout()手动设置token过期时间；
6. 在分布式环境中确保各节点使用相同的Sa-Token配置；
7. 结合日志记录token生成、验证、失效的全过程。