Lettuce 6.0+才原生支持spring.redis.sentinel.password,此前版本需手动构造RedisSentinelConfiguration并调用setSentinelPassword();该配置与spring.redis.password作用域不同,不可混用或省略,且受配置加载顺序、profile激活及特殊字符URL编码影响。

Spring Boot的spring.redis.sentinel.password不生效?先确认Lettuce是否支持
Spring Boot 2.2+ 默认使用 Lettuce 客户端,而它对哨兵密码的支持存在版本断层:Lettuce 6.0.0.RELEASE 之前根本不解析 spring.redis.sentinel.password 配置项。你写了,Spring Boot 也读进去了,但 Lettuce 初始化时直接忽略——这就是“配置写了却没用”的根本原因。
验证方式很简单:启动时加 --debug 或查看日志里是否有 SentinelConfiguration 相关初始化输出;更直接的是打断点进 RedisSentinelConfiguration 构造逻辑,看 setSentinelPassword() 是否被调用。
- Spring Boot 2.1.x + Lettuce 5.x:不支持
sentinel.password,必须手动构造RedisSentinelConfiguration - Spring Boot 2.3+ + Lettuce 6.0+:原生支持,但需确保未被自定义
@Bean覆盖 - 若用 Jedis,该配置压根不生效(Jedis 自己解析 yml,且只认
spring.redis.password)
spring.redis.password 和 spring.redis.sentinel.password 混用会覆盖认证目标
这两个配置不是“并列生效”,而是有明确优先级和作用域:spring.redis.password 是主节点连接密码,spring.redis.sentinel.password 是连接哨兵节点时的认证凭据。但如果主节点和哨兵共用同一套密码(常见于简单部署),误把密码全填在 spring.redis.password 里,哨兵通信就会失败——因为哨兵节点本身也需要单独认证(尤其开启 ACL 后)。
典型错误现象是应用启动时报 NOAUTH Authentication required,但错误堆栈指向哨兵连接(如 io.lettuce.core.RedisConnectionException: Unable to connect...)。
- 主节点密码 → 填
spring.redis.password - 哨兵节点密码 → 必须填
spring.redis.sentinel.password(Lettuce 6.0+)或手动 set - 两者都为空 → 连哨兵不鉴权,连主节点报
NOAUTH - 只填
spring.redis.password→ 哨兵连接失败,无法获取当前 master 地址
Redisson 的 sentinel-password 必须显式声明,且不能复用 password
如果你项目里同时用了 Spring Data Redis(Lettuce)和 Redisson(比如做分布式锁),注意 Redisson 的哨兵配置完全独立,它不会读取 Spring 的 spring.redis.* 配置。它的哨兵密码字段叫 sentinel-password,且必须和 password(主节点密码)分开传。
常见错误是把主节点密码直接当哨兵密码用,或者漏写 sentinel-password 字段。Redisson 日志里如果出现 Cannot connect to sentinel 或反复重试连接哨兵地址,大概率是这个原因。
- Redisson 配置中
password仅用于主/从节点认证 -
sentinel-password才用于连接sentinel-addresses中每个哨兵实例 - 两者值相同时也要分别配置,不能省略
sentinel-password - 密码含特殊字符(如
@、#)必须 URL 编码,否则 YAML 解析失败
配置加载顺序和 profile 激活导致密码“消失”
最隐蔽的坑:密码配置被 profile 覆盖或未激活。比如你在 application-dev.yml 里写了 spring.redis.sentinel.password,但启动参数是 --spring.profiles.active=test,而 application-test.yml 里没配这个字段——结果运行时该值为 null,Lettuce 初始化哨兵连接时不带 AUTH,哨兵拒绝响应。
另一个高频场景是 Apollo/Nacos 等配置中心,sentinel.password 字段名拼错(比如写成 sentinal.password)、权限不足未拉取、或配置未发布,都会导致空密码被注入。
- 启动时加
--logging.level.org.springframework.boot.autoconfigure.data.redis=DEBUG,看配置绑定日志 - 用
redis-cli -p 26379 -a your_sentinel_password sentinel masters mymaster手动验证哨兵是否可连 - 检查
spring.redis.sentinel.nodes是否误写成spring.redis.sentinel.addresses(旧版命名) - Docker 环境下确认配置文件挂载路径与 Spring Boot 实际读取路径一致


















