Sa-Token 版本升级导致登录异常问题分析与解决方案

2025-05-12 13:13:00作者：魏献源Searcher

问题背景

在Sa-Token权限认证框架从1.40.0版本升级到1.42.0版本的过程中，部分开发者遇到了登录异常问题。具体表现为：当使用StpUtil.login()方法进行登录时，系统抛出SaJsonConvertException异常，提示无法找到cn.dev33.satoken.dao.SaSessionForJacksonCustomized类。

问题原因分析

这个问题源于Sa-Token在1.42.0版本中对会话存储机制进行了优化和重构。在1.40.0版本中，会话对象是通过SaSessionForJacksonCustomized类进行JSON序列化存储的，而在新版本中，这个类已被移除，取而代之的是更高效的会话存储方式。

当系统升级后，Redis中仍然保存着旧版本的会话数据（格式为SaSessionForJacksonCustomized），而新版本无法识别这种格式，导致反序列化失败。这种情况通常发生在以下场景：

项目从1.40.0或更早版本升级到1.42.0或更高版本
使用了Redis等持久化存储来保存会话信息
升级前已存在活跃会话数据

解决方案

方案一：清理Redis会话数据（推荐）

最彻底的解决方案是清理Redis中存储的所有旧会话数据：

连接到Redis服务器
执行以下命令清除所有Sa-Token相关数据：
```
FLUSHDB
```
或者更精确地只删除Sa-Token相关的键：
```
KEYS "Dsmt-Token:*" | xargs redis-cli DEL
```
重启应用服务
让用户重新登录，系统会自动创建新格式的会话数据

方案二：实现自定义反序列化逻辑（适用于不能立即清理数据的场景）

如果业务上不允许立即清理所有会话数据，可以实现自定义的反序列化逻辑来处理旧格式数据：

@Configuration
public class SaTokenConfig {
    @Bean
    public SaJsonConvert saJsonConvert() {
        return new SaJsonConvert() {
            @Override
            public String toJsonString(Object obj) {
                // 自定义序列化逻辑
                return JSON.toJSONString(obj);
            }
            
            @Override
            public <T> T parseJsonToObject(String jsonStr, Class<T> clazz) {
                try {
                    return JSON.parseObject(jsonStr, clazz);
                } catch (Exception e) {
                    // 处理旧格式数据
                    if(jsonStr.contains("SaSessionForJacksonCustomized")) {
                        // 转换逻辑
                        return convertLegacySession(jsonStr, clazz);
                    }
                    throw e;
                }
            }
        };
    }
    
    private <T> T convertLegacySession(String jsonStr, Class<T> clazz) {
        // 实现旧格式到新格式的转换逻辑
    }
}