JetCache连接Redis Sentinel的密码配置实践

背景介绍

JetCache作为阿里巴巴开源的Java缓存框架，支持多种缓存后端，包括Redis。在实际生产环境中，Redis Sentinel模式是常用的高可用方案。然而，当Sentinel服务本身配置了密码认证时，JetCache的配置会变得复杂，这也是本文要探讨的核心问题。

问题分析

在JetCache配置Redis Sentinel时，常见的配置方式是通过URI格式指定Sentinel节点和主节点信息。当Sentinel服务启用了密码认证，配置会面临以下挑战：

1. Redis节点密码和Sentinel密码是独立的
2. Lettuce客户端默认不支持在URI中直接配置Sentinel密码
3. JetCache官方文档对此场景的说明不够详细

配置方案对比

方案一：使用Spring Data Redis适配器

对于Spring Boot项目，最简单的解决方案是切换依赖：

<dependency>
    <groupId>com.alicp.jetcache</groupId>
    <artifactId>jetcache-starter-redis-springdata</artifactId>
    <version>${jetcache.version}</version>
</dependency>

这种方案利用了Spring Data Redis对Sentinel的原生支持，可以更简单地处理密码认证问题。

方案二：修改Lettuce源码

对于必须使用Lettuce客户端的场景，可以通过修改Lettuce源码实现Sentinel密码支持。核心修改点包括：

1. 在RedisURI.configureSentinel()方法中解析URI参数
2. 添加对sentinelPassword参数的支持
3. 将密码设置到Sentinel的RedisURI对象中

关键代码修改如下：

private static Builder configureSentinel(URI uri) {
    // 解析sentinelPassword参数
    char[] sentinelPassword = parseSentinelPassword(uri);
    // ...其他代码
    if (builder == null && LettuceStrings.isNotEmpty(uri.getAuthority())) {
        // 设置sentinel密码
        builder.sentinelPassword = sentinelPassword;
    }
    // ...其他代码
}

最佳实践建议

1. 优先使用Spring Data适配器：对于Spring Boot项目，这是最简单可靠的方案
2. 密码安全：避免在配置文件中明文存储密码，考虑使用配置中心或加密方案
3. 连接池配置：合理设置连接池参数，如示例中的minIdle、maxIdle等
4. 多环境支持：使用变量替换（如${spring.application.name}）提高配置的灵活性

配置示例

以下是结合了密码配置的JetCache完整配置示例：

jetcache:
  remote:
    default:
      type: redis.lettuce
      keyPrefix: '${spring.application.name}:'
      password: '${redis.password}'  # Redis节点密码
      uri: redis-sentinel://${redis.password}@host1:port1,host2:port2/dbIndex?sentinelMasterId=mymaster&sentinelPassword=${sentinel.password}
      poolConfig:
        minIdle: 5
        maxIdle: 20
        maxTotal: 50

总结

JetCache连接带密码认证的Redis Sentinel集群时，开发者需要特别注意密码配置的层次性。通过本文介绍的两种方案，开发者可以根据项目实际情况选择最适合的接入方式。对于大多数Spring Boot项目，使用Spring Data适配器是最简单可靠的方案；而对于需要深度定制的情况，则可以考虑修改Lettuce客户端源码的方案。