redisson-spring-boot-starter 哨兵配置

<think>嗯，用户之前问过关于Redis Starter的问题，现在又想知道Spring Boot的两个Starter：spring-boot-starter-data-redis和redisson-spring-boot-starter之间的关系。我需要先理清楚这两个组件的区别和联系。 首先，用户可能是在使用Spring Boot集成Redis时遇到了选择哪个Starter的问题，或者对两者的功能有疑惑。他们可能已经知道基础的Redis集成，但需要更高级的功能，比如分布式锁或者其他Redis高级特性，所以才会提到Redisson。 接下来，我需要回忆这两个Starter的作用。Spring Boot官方的starter-data-redis是基于Lettuce或Jedis的，提供基本的连接和操作模板，比如RedisTemplate。而Redisson的starter则是基于Redisson客户端，支持更多的分布式服务，比如分布式集合、锁、调度等。两者都是用来集成Redis，但实现的客户端不同，功能侧重点不同。 用户可能想知道它们是否可以一起使用，或者是否有冲突。需要解释它们各自的定位，比如官方starter适合基础操作，Redisson适合需要分布式功能的场景。同时，要指出两者在配置上的差异，比如Redisson可能需要不同的配置方式，使用YAML文件而不是简单的host和port。 另外，用户可能对如何选择这两个Starter感到困惑，需要给出使用场景的建议。比如，如果只需要缓存和简单的数据操作，官方Starter足够；但如果需要分布式锁、分布式对象，就应该选Redisson。还要提到在极端情况下可以混合使用，但需要处理配置冲突的问题。 需要注意之前用户的问题中已经提到了配置示例和自动配置类，这次回答可能需要对比两者的配置方式，比如Redisson使用自己的配置文件格式，而官方Starter用Spring的配置属性。还要提到依赖管理的区别，比如Redisson需要引入自己的starter依赖，而官方的是Spring Boot自带的。 可能用户在实际项目中遇到了依赖冲突，或者配置不生效的情况，所以需要强调版本兼容性和配置隔离的重要性。比如，如果同时使用两个客户端，需要确保它们不互相干扰，可能要通过自定义配置类来明确指定各自的连接工厂。 最后，总结两者的关系是互补和替代并存，根据需求选择合适的工具。同时，提醒用户注意版本匹配，避免因为版本不一致导致的问题。</think>以下是关于 `spring-boot-starter-data-redis` 与 `redisson-spring-boot-starter` 的对比解析，通过三个维度说明它们的关系： --- ### 一、**核心定位对比** | **组件** | **核心能力** | **适用场景** | |------------------------------|----------------------------------------------------------------------------|-----------------------------------| | `spring-boot-starter-data-redis` | Spring 官方提供的 Redis 基础集成：<br>- 基于 Lettuce/Jedis 客户端<br>- 提供 `RedisTemplate` 等基础 API<br>- 支持简单缓存、数据存储 | 需要基本 Redis 操作的常规场景 | | `redisson-spring-boot-starter` | Redisson 客户端的高级封装：<br>- 实现分布式对象（Map、Lock、Queue 等）<br>- 支持哨兵/集群模式<br>- 提供延迟队列、布隆过滤器等高级功能 | 分布式系统开发（如分布式锁、分布式限流、复杂数据结构） | --- ### 二、**技术实现差异** #### 1. **客户端架构** - **官方 Starter** ```java // 默认使用 Lettuce 连接池 LettuceConnectionFactory factory = new LettuceConnectionFactory(); RedisTemplate<String, Object> template = new RedisTemplate<>(); template.setConnectionFactory(factory); ``` 优势：轻量级，I/O 多路复用，适合高并发简单操作 - **Redisson Starter** ```java // 基于 Netty 的异步非阻塞模型 Config config = new Config(); config.useSingleServer().setAddress("redis://127.0.0.1:6379"); RedissonClient client = Redisson.create(config); ``` 优势：支持 60+ 分布式对象，提供 RPC 式调用接口 #### 2. **配置方式对比** - **官方 Starter** ```yaml spring: redis: host: localhost port: 6379 lettuce: pool: max-active: 8 ``` - **Redisson Starter** ```yaml redisson: config: | singleServerConfig: address: "redis://localhost:6379" connectionMinimumIdleSize: 5 ``` --- ### 三、**协同与互斥关系** #### 1. **依赖冲突** - **不可共存场景** 若同时引入两个 Starter 且未隔离配置，会导致： - `RedisTemplate` 与 `RedissonClient` 使用不同连接池 - 配置参数互相覆盖（如超时时间、连接数） #### 2. **混合使用方案** ```java @Configuration public class DualClientConfig { // 官方 Starter 的 RedisTemplate @Bean public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) { return new RedisTemplate<>(){/* 基础操作 */}; } // Redisson 客户端（独立配置） @Bean(destroyMethod = "shutdown") public RedissonClient redissonClient() { Config config = new Config(); config.useClusterServers().addNodeAddress("redis://node1:6379"); return Redisson.create(config); } } ``` **注意事项**：需确保两个客户端使用不同的 Redis 数据库或独立配置连接池 --- ### **选择建议** 1. **优先官方 Starter**：若仅需缓存、简单 K-V 存储 2. **必选 Redisson**：若涉及以下场景： ```markdown - 分布式锁（RLock） - 分布式限流（RRateLimiter） - 跨 JVM 的 Topic 消息广播 - 延迟队列（RDelayedQueue） ``` 3. **慎用混合模式**：仅在明确需求分离时使用（如基础操作与高级功能分离） --- ### **版本兼容性** | Spring Boot 版本 | 官方 Starter 推荐版本 | Redisson Starter 推荐版本 | |----------------|---------------------|-------------------------| | 2.7.x | 2.7.18 | 3.23.2 | | 3.1.x | 3.1.5 | 3.25.0 | 建议通过 `mvn dependency:tree` 验证依赖树，避免客户端版本冲突。

### 配置 Redisson 使用 Sentinel 哨兵模式 #### 1. Maven 依赖配置 为了使用 Redisson 连接 Redis 的哨兵模式，在项目的 `pom.xml` 文件中添加如下依赖： ```xml <dependency> <groupId>org.redisson</groupId> <artifactId>redisson-spring-boot-starter</artifactId> <version>3.11.5</version> </dependency> ``` 此版本兼容 Spring Boot 版本 2.1.13。 #### 2. 应用属性文件配置 在应用的 `application.properties` 或者 `application.yml` 中定义 Redisson 和 Sentinel 的连接参数。以下是 YAML 格式的示例配置[^2]： ```yaml spring: redis: sentinel: master: mymaster nodes: 127.0.0.1:26379,127.0.0.1:26380,127.0.0.1:26381 data: redis: password: your_redis_password ``` 这里指定了主节点名称 (`mymaster`) 及其对应的哨兵节点地址列表，以及设置了 Redis 密码来防止未授权访问漏洞 (CNVD-2019-21763)。 #### 3. Java 配置类方式 除了通过配置文件外，还可以创建自定义 Bean 来初始化 RedissonClient 实现更灵活的配置选项。下面是一个简单的例子说明如何做到这一点: ```java import org.redisson.Redisson; import org.redisson.api.RedissonClient; import org.redisson.config.Config; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; @Configuration public class RedissonConfig { @Bean public RedissonClient redisson() { Config config = new Config(); // 设置哨兵模式下Redis服务器的相关信息 config.useSentinelServers() .setMasterName("mymaster") // 主机名 .addSentinelAddress( "redis://127.0.0.1:26379", "redis://127.0.0.1:26380", "redis://127.0.0.1:26381" ) .setPassword("your_redis_password"); // 设置密码 return Redisson.create(config); } } ``` 这段代码展示了如何利用编程的方式构建一个带有哨兵支持并启用了身份验证机制的客户端实例。