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 实际读取路径一致
复杂点在于，哨兵密码失效不会立刻报错，而是表现为连接超时、随机 fallback 到旧主节点、或故障转移后客户端卡死——这些表象都和密码无关，但根因往往就在这里。别急着调连接池或重试策略，先抓包看客户端发给哨兵的请求里有没有 AUTH 命令。
