在 Spring Boot 开发中，Redis 作为高性能缓存和分布式数据存储方案被广泛使用。而RedisAutoConfiguration作为 Spring Boot 自动装配体系的重要组成部分，能够帮我们快速完成 Redis 客户端的配置。本文将从源码角度解析RedisAutoConfiguration的工作原理，结合实际场景演示如何基于自动配置进行自定义扩展。

一、RedisAutoConfiguration 的核心作用与触发条件

1. 自动装配的核心价值

• 零配置启动：引入spring-boot-starter-data-redis依赖后，无需手动编写连接工厂、模板类等配置代码

• 兼容多客户端：自动适配 Lettuce 和 Jedis 两种主流 Redis 客户端

• 参数化配置：通过application.properties集中管理 Redis 连接参数

2. 触发自动配置的条件

@Configuration(proxyBeanMethods = false)
@ConditionalOnClass(RedisOperations.class) // 存在Redis操作接口时生效
@EnableConfigurationProperties(RedisProperties.class) // 加载Redis配置属性类
@Import({ LettuceConnectionConfiguration.class, JedisConnectionConfiguration.class })
public class RedisAutoConfiguration {

• @ConditionalOnClass：检查类路径中是否存在RedisOperations（Spring Data Redis 核心接口）

• 依赖传递：当引入spring-boot-starter-data-redis时，会自动包含lettuce-core或jedis依赖

二、核心配置类与属性映射

1. RedisProperties 属性映射

@ConfigurationProperties(prefix = "spring.redis")
public class RedisProperties {
    private String host = "localhost"; // 主机地址
    private int port = 6379; // 端口
    private String password; // 密码
    private int database = 0; // 数据库索引
    private Jedis jedis = new Jedis(); // Jedis连接池配置
    private Lettuce lettuce = new Lettuce(); // Lettuce连接配置
    
    // 内部类定义连接池参数（如maxIdle、timeout等）
}

支持的配置示例：

spring.redis.host=192.168.1.100
spring.redis.port=6380
spring.redis.password=your-password
spring.redis.database=1
spring.redis.jedis.pool.max-idle=10
spring.redis.lettuce.shutdown-timeout=100ms

2. 连接工厂自动配置

Lettuce 客户端配置（默认）

@Configuration(proxyBeanMethods = false)
@ConditionalOnClass(LettuceConnectionFactory.class)
@ConditionalOnMissingBean(name = "redisConnectionFactory") // 无自定义连接工厂时生效
static class LettuceConnectionConfiguration {
    @Bean
    public LettuceConnectionFactory lettuceConnectionFactory(RedisProperties properties) {
        return createLettuceConnectionFactory(properties);
    }
}

Jedis 客户端配置（需显式引入 jedis 依赖）

@Configuration(proxyBeanMethods = false)
@ConditionalOnClass(JedisConnectionFactory.class)
@ConditionalOnMissingBean(name = "redisConnectionFactory")
static class JedisConnectionConfiguration {
    @Bean
    public JedisConnectionFactory jedisConnectionFactory(RedisProperties properties) {
        return createJedisConnectionFactory(properties);
    }
}

3. 操作模板自动配置

@Bean
@ConditionalOnMissingBean
public RedisTemplate<Object, Object> redisTemplate(
        RedisConnectionFactory redisConnectionFactory) throws UnknownHostException {
    RedisTemplate<Object, Object> template = new RedisTemplate<>();
    template.setConnectionFactory(redisConnectionFactory);
    // 设置默认序列化方式（JDK序列化，可自定义修改）
    template.setDefaultSerializer(new JdkSerializationRedisSerializer());
    return template;
}
@Bean
@ConditionalOnMissingBean
public StringRedisTemplate stringRedisTemplate(
        RedisConnectionFactory redisConnectionFactory) throws UnknownHostException {
    StringRedisTemplate template = new StringRedisTemplate();
    template.setConnectionFactory(redisConnectionFactory);
    return template;
}

三、自定义配置扩展实践

1. 替换默认序列化方式（JSON 序列化）

@Configuration
public class RedisConfig {
    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory factory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(factory);
        
        // 使用Jackson2JSON序列化
        Jackson2JsonRedisSerializer<Object> serializer = new Jackson2JsonRedisSerializer<>(Object.class);
        ObjectMapper mapper = new ObjectMapper();
        mapper.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
        mapper.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL);
        serializer.setObjectMapper(mapper);
        template.setKeySerializer(new StringRedisSerializer());
        template.setValueSerializer(serializer);
        template.setHashKeySerializer(new StringRedisSerializer());
        template.setHashValueSerializer(serializer);
        
        return template;
    }
}

2. 配置连接池参数（以 Jedis 为例）

spring.redis.jedis.pool.max-active=50  # 最大连接数
spring.redis.jedis.pool.max-idle=10   # 最大空闲连接
spring.redis.jedis.pool.min-idle=5    # 最小空闲连接
spring.redis.timeout=3000ms           # 连接超时时间

3. 自定义 RedisConnectionFactory

@Bean
public RedisConnectionFactory customRedisConnectionFactory(RedisProperties properties) {
    RedisStandaloneConfiguration config = new RedisStandaloneConfiguration();
    config.setHostName("custom-host");
    config.setPort(6381);
    config.setPassword("custom-password");
    config.setDatabase(2);
    
    return new LettuceConnectionFactory(config);
}

四、条件注解与装配顺序解析

1. 客户端选择逻辑

2. 自定义 Bean 覆盖规则

• 当用户自定义RedisConnectionFactory时，自动配置的lettuceConnectionFactory/jedisConnectionFactory会被忽略

• 通过@ConditionalOnMissingBean实现 "用户配置优先" 原则

3. 配置属性加载顺序

1. 系统环境变量

2. application.properties/yml

3. 命令行参数

4. 默认值（如host=localhost, port=6379）

五、生产环境最佳实践

1. 连接池优化

# Jedis连接池配置
spring.redis.jedis.pool.max-wait=1000ms  # 连接等待超时时间
spring.redis.jedis.pool.test-on-borrow=true  # 借用连接时检测有效性
# Lettuce连接配置（非连接池模式）
spring.redis.lettuce.shutdown-timeout=500ms  # 关闭超时时间

代码解读

spring.redis.cluster.nodes=192.168.1.1:7000,192.168.1.2:7001
spring.redis.cluster.max-redirects=3

2. 集群模式配置

spring.redis.cluster.nodes=192.168.1.1:7000,192.168.1.2:7001
spring.redis.cluster.max-redirects=3

3. 哨兵模式配置

spring.redis.sentinel.master=myMaster
spring.redis.sentinel.nodes=192.168.1.3:26379,192.168.1.4:26380

4. 监控与管理

@Bean
public RedisHealthIndicator redisHealthIndicator(RedisConnectionFactory factory) {
    return new RedisHealthIndicator(factory);
}

六、常见问题与解决方案

1. 多 Redis 实例配置

@Bean
public RedisConnectionFactory primaryRedisConnectionFactory(RedisProperties primaryProps) {
    // 主实例配置
}
@Bean
public RedisConnectionFactory secondaryRedisConnectionFactory(RedisProperties secondaryProps) {
    // 从实例配置
}

2. 序列化导致的类型问题

• 现象：存储对象时出现class cannot be resolved异常

• 解决方案：使用Jackson2JsonRedisSerializer替代默认的 JDK 序列化

3. 连接超时问题

• 检查spring.redis.timeout配置是否小于 Redis 服务器响应时间

• 确保防火墙开放 Redis 端口（默认 6379）

总结：自动配置背后的设计哲学

RedisAutoConfiguration体现了 Spring Boot"约定大于配置" 的核心思想：

1. 零侵入性：完全兼容手动配置，通过@ConditionalOnMissingBean实现平滑扩展

2. 适应性：自动检测依赖并选择合适的客户端实现

3. 可观测性：所有配置参数均可通过RedisProperties追溯和修改