Sa-Token-Alone-Redisson 独立 Redisson 插件 ​

Sa-Token 默认的 Redisson 集成会把权限数据和业务缓存放在同一个 RedissonClient 上。需要彻底分离时，可再为 Sa-Token 单独起一个 Redisson 连接。

1、引入依赖 ​

引入 sa-token-alone-redisson 即可，无需再引入 sa-token-redisson 或 sa-token-redisson-spring-boot-starter（本插件已包含 Dao 实现并完成注册）。

业务代码如果也要用 RedissonClient：

• Spring Boot 2 / 3：可再引入官方 redisson-spring-boot-starter，或自行注册 Bean。
• Spring Boot 4：当前 Redisson 3.45 的 starter 仍引用已移除的 RedisAutoConfiguration，不要引入 redisson-spring-boot-starter，改为引入 redisson 并自行注册 Bean。sa-token-alone-redisson 本身无需 Boot 4 专用包。

<!-- Sa-Token 插件：权限缓存与业务缓存分离（Redisson） -->
<dependency>
	<groupId>cn.dev33</groupId>
	<artifactId>sa-token-alone-redisson</artifactId>
	<version>1.46.0</version>
</dependency>

<!-- 业务 Redis（按需） -->
<dependency>
	<groupId>org.redisson</groupId>
	<artifactId>redisson-spring-boot-starter</artifactId>
	<version>${redisson.version}</version>
</dependency>

2、配置独立连接（Redisson 原生 yaml） ​

配置项与官方 spring.redis.redisson.config / file 相同，单机用 singleServerConfig，集群用 clusterServersConfig。

sa-token:
    token-name: satoken
    timeout: 2592000
    # Sa-Token 单独使用的 Redisson 连接
    alone-redisson:
        config: |
            singleServerConfig:
                address: "redis://127.0.0.1:6379"
                database: 2
                password: null

spring:
    redis:
        # 业务使用的 Redisson 连接
        redisson:
            config: |
                singleServerConfig:
                    address: "redis://127.0.0.1:6379"
                    database: 0
                    password: null

config 与 file 二选一，同时配置时优先 config。

完整示例：

• 单机：sa-token-demo-alone-redisson
• 集群：sa-token-demo-alone-redisson-cluster
• Spring Boot 3：sa-token-demo-alone-redisson-sb3
• Spring Boot 4：sa-token-demo-alone-redisson-sb4

3、测试 ​

@RestController
@RequestMapping("/test/")
public class TestController {

	@Autowired
	RedissonClient redissonClient;

	// 测试 Sa-Token 缓存 --- http://localhost:8084/test/login
	@RequestMapping("login")
	public SaResult login(@RequestParam(defaultValue="10001") String id) {
		StpUtil.login(id);
		return SaResult.ok();
	}

	// 测试业务缓存 --- http://localhost:8084/test/test
	@RequestMapping("test")
	public SaResult test() {
		redissonClient.getBucket("hello").set("Hello World");
		return SaResult.ok();
	}
}

分别访问两个接口，观察两套 Redis 中增加的数据。

4、注意点 ​

• 引入本插件后，无需再引入 sa-token-redisson 或 sa-token-redisson-spring-boot-starter。
• 业务代码注入的 RedissonClient 来自官方 redisson-spring-boot-starter 或你自己注册的 Bean，与 Sa-Token 使用的独立连接互不影响。Spring Boot 4 请自行注册，不要引入 3.45 的 starter。
• SaTokenDaoForRedisson 默认使用 StringCodec，与业务 RedissonClient 的全局 codec 无关。
• Redis Cluster 没有 database 索引，集群配置里不要写 database。
• 哨兵模式同样走 Redisson 原生 yaml（sentinelServersConfig），按 Redisson 配置文档 填写即可。