如何为ElastiCache在Redisson.yaml中通过环境变量切换单节点/集群模式？

问题根源 #

你之前在YAML里写条件判断导致Jackson报错，是因为Redisson的YAML解析依赖Jackson，而Jackson把#当成注释符号，不支持原生的条件语法，Redisson本身也没提供在配置文件里写条件判断的功能，所以得换思路实现。

可行方案 #

方案1：程序化配置（最直接可控）

直接在Java代码里读取环境变量，根据REDIS_MODE的值选择加载单节点或集群配置：

// 初始化Redisson配置
Config config = new Config();
// 获取环境变量，默认值设为single
String redisMode = System.getenv().getOrDefault("REDIS_MODE", "single");

if ("single".equals(redisMode)) {
    // 配置ElastiCache单节点模式
    SingleServerConfig singleServer = config.useSingleServer();
    singleServer.setAddress("redis://your-elasticache-single-endpoint:6379");
    // 按需添加其他配置：密码、连接池大小、超时时间等
    // singleServer.setPassword("your-password");
    // singleServer.setConnectionPoolSize(10);
} else if ("cluster".equals(redisMode)) {
    // 配置ElastiCache集群模式
    ClusterServersConfig clusterServer = config.useClusterServers();
    clusterServer.addNodeAddress(
        "redis://your-elasticache-cluster-node1:6379",
        "redis://your-elasticache-cluster-node2:6379",
        "redis://your-elasticache-cluster-node3:6379"
    );
    // 按需添加集群专属配置：扫描间隔、负载均衡策略等
    // clusterServer.setScanInterval(2000);
}

// 创建Redisson客户端
RedissonClient redissonClient = Redisson.create(config);

方案2：Spring环境下用多配置文件+条件注解

如果是Spring Boot项目，可以拆分两个Redisson配置文件，用@ConditionalOnProperty根据环境变量自动加载对应配置：

1. 新建redisson-single.yaml（单节点配置）：

singleServerConfig:
  address: "redis://your-elasticache-single-endpoint:6379"
  # 其他单节点配置项

2. 新建redisson-cluster.yaml（集群配置）：

clusterServersConfig:
  nodeAddresses:
    - "redis://your-elasticache-cluster-node1:6379"
    - "redis://your-elasticache-cluster-node2:6379"
  # 其他集群配置项

3. 编写Spring配置类：

@Configuration
public class RedissonConfig {

    // 默认加载单节点配置（REDIS_MODE未设置或为single时生效）
    @Bean
    @ConditionalOnProperty(name = "REDIS_MODE", havingValue = "single", matchIfMissing = true)
    public RedissonClient singleRedissonClient() throws IOException {
        return Redisson.create(Config.fromYAML(new ClassPathResource("redisson-single.yaml").getInputStream()));
    }

    // REDIS_MODE为cluster时加载集群配置
    @Bean
    @ConditionalOnProperty(name = "REDIS_MODE", havingValue = "cluster")
    public RedissonClient clusterRedissonClient() throws IOException {
        return Redisson.create(Config.fromYAML(new ClassPathResource("redisson-cluster.yaml").getInputStream()));
    }
}

注意事项 #

• 不要在Redisson的YAML配置里写条件逻辑，Redisson不支持这种语法，只会导致解析错误。
• 环境变量REDIS_MODE的值要严格匹配代码里的判断（比如小写的single/cluster），避免大小写问题导致配置加载错误。

内容的提问来源于stack exchange，提问作者Ganesh Prajapati