Redisson连接Sentinel模式Redis的配置问题解析

在使用Redisson连接Sentinel模式的Redis集群时，开发者可能会遇到"Unable to connect"的错误提示。本文将通过一个典型问题案例，深入分析问题原因并提供解决方案。

问题现象

当使用Redisson 3.33.0版本连接Sentinel模式的Redis 6.0.0集群时，应用启动失败并抛出连接异常。错误信息显示无法连接到Redis服务器，尽管通过redis-cli可以正常连接目标地址10.10.10.43:6379。

配置分析

典型的Spring Boot配置如下：

spring.data.redis.sentinel.master=${REDIS_SENTINEL_MASTER}
spring.data.redis.sentinel.nodes=${REDIS_SENTINEL_NODES}
spring.data.redis.sentinel.password=${REDIS_SENTINEL_PASSWORD:}
spring.data.redis.sentinel.username=${REDIS_SENTINEL_USERNAME:}
spring.data.redis.database=${REDIS_DATABASE:0}
spring.data.redis.password=${REDIS_PASSWORD:}
spring.data.redis.username=${REDIS_USERNAME:}

问题根源

经过排查发现，问题出在同时配置了Sentinel和普通Redis连接参数上。具体来说：

1. spring.data.redis.password和spring.data.redis.username这两个配置项会覆盖Sentinel的认证信息
2. 在Redisson 3.33.0版本中，这种配置会导致连接Sentinel时错误地使用Redis实例的认证信息
3. 而在早期版本(如3.16.8)中，这种配置方式可以正常工作

解决方案

1. 推荐方案：移除普通Redis连接参数，仅保留Sentinel相关配置：

   spring.data.redis.sentinel.master=${REDIS_SENTINEL_MASTER}
   spring.data.redis.sentinel.nodes=${REDIS_SENTINEL_NODES}
   spring.data.redis.sentinel.password=${REDIS_SENTINEL_PASSWORD:}
   spring.data.redis.sentinel.username=${REDIS_SENTINEL_USERNAME:}
   spring.data.redis.database=${REDIS_DATABASE:0}
   

2. 调试建议：如需进一步诊断，可以：

   • 设置org.redisson日志级别为TRACE
   • 调试RedissonAutoConfiguration.redisson()方法
   • 检查是否存在自定义的RedisConnectionDetails配置

版本兼容性说明

这个问题凸显了不同Redisson版本在配置处理上的差异：

• 3.16.8及更早版本：对混合配置容忍度较高
• 3.33.0版本：对配置项要求更严格，需要明确区分Sentinel和Redis实例的认证信息

最佳实践

1. 保持配置简洁，避免冗余参数
2. 明确区分Sentinel和Redis实例的认证信息
3. 升级版本时注意测试连接配置
4. 使用条件配置管理Redis启用状态（如示例中的@ConditionalOnProperty）

通过遵循这些实践，可以确保Redisson与Sentinel模式Redis集群的稳定连接。