RedisAutoConfiguration被静默跳过，主因是@ConditionalOnClass未找到RedisConnectionFactory类或@ConditionalOnMissingBean已存在同类型Bean；需检查spring-data-redis与lettuce-core依赖是否齐全、排除jedis冲突、警惕@EnableRedisHttpSession的隐式禁用，以及测试中上下文是否正确加载。
RedisAutoConfiguration被静默跳过？先看自动配置报告
Spring Boot 启动时没报错，但 RedisConnectionFactory 找不到或为 null，大概率是 RedisAutoConfiguration 根本没加载成功。它不是“失败”，而是被条件判断直接跳过了——你得主动把它揪出来。
启动时加参数：--debug 或在 application.properties 里写 logging.level.org.springframework.boot.autoconfigure=DEBUG。启动日志末尾会出现 AUTO-CONFIGURATION REPORT，搜索 RedisAutoConfiguration，看它是否出现在 Unconditional classes 或 Exclusions 里。更常见的是出现在 Exclusions 下，并附带类似这样的提示：
RedisAutoConfiguration:
Did not match:
- @ConditionalOnClass did not find required class 'org.springframework.data.redis.connection.RedisConnectionFactory' (OnClassCondition)
- @ConditionalOnMissingBean (types: org.springframework.data.redis.connection.RedisConnectionFactory; SearchStrategy: all) found beans 'redisConnectionFactory' (OnBeanCondition)注意这两条：前者说明类路径缺失关键依赖；后者说明已有同类型 Bean，自动配置主动让位。
spring-data-redis 和 lettuce-core 缺一不可
Spring Boot 3.x/4.x 默认只认 Lettuce，且要求两个依赖同时存在才能触发自动装配。只加 spring-boot-starter-data-redis 不够，它不强制传递 lettuce-core，尤其在 Maven 多模块或旧版 starter 场景下容易漏掉。
- 必须显式声明
io.lettuce:lettuce-core（Spring Boot 3.x 对应 Lettuce 6.x，4.x 对应 7.x） - 若项目里还引入了
redis.clients:jedis，要确保它被excluded，否则可能引发客户端冲突或条件判断混乱 - 检查
mvn dependency:tree | grep redis输出，确认lettuce-core真实在 classpath 中，且版本与 Spring Boot 版本兼容（如 Spring Boot 4.1.1 对应 Lettuce 7.5.2.RELEASE）
@EnableRedisHttpSession 是最隐蔽的“关闭开关”
这个注解来自 spring-session-data-redis，它表面是启用 Redis Session，实际会悄悄禁用 RedisAutoConfiguration。官方文档里那句小字很关键：
> "When using @EnableRedisHttpSession, the RedisAutoConfiguration will be disabled to avoid configuration conflicts"
它的实现机制是：通过 @Import(RedisHttpSessionConfiguration.class) 提前注册了 RedisConnectionFactory Bean，导致 RedisAutoConfiguration 的 @ConditionalOnMissingBean 条件不满足，整个自动配置类被跳过。
如果你既用了 @EnableRedisHttpSession 又想复用自动配置生成的连接工厂（比如还要用 RedisTemplate），不能靠“覆盖”解决：
- 错误做法：
@Bean硬编码返回LettuceConnectionFactory，破坏配置驱动能力 - 正确做法：删掉
@EnableRedisHttpSession，改用 Spring Session 官方推荐的配置方式——在application.yml中设spring.session.store-type=redis，让自动配置链统一接管
单元测试里 RedisConnectionFactory 为空？上下文根本没起来
这是开发中最常忽略的“假失败”：测试类没加载 Spring 上下文，@Resource 或 @Autowired 注入自然为空，和自动配置无关。
必须同时满足两个条件：
- 测试类上加
@SpringBootTest（启动完整上下文）或@DataJpaTest等组合注解（需确认是否包含 Redis 相关支持） - 使用 Spring 提供的测试运行器：
@ExtendWith(SpringExtension.class)（JUnit 5）或@RunWith(SpringRunner.class)（JUnit 4）
如果只想测连接工厂本身，不启全量上下文，可用 @ContextConfiguration(classes = {RedisAutoConfiguration.class}) 显式指定配置类，但要注意它依赖的其他自动配置（如 CommonsPool2ConnectionPoolConfiguration）也得一并带上，否则仍会失败。
真正难排查的从来不是报错，而是“什么都没发生”。RedisConnectionFactory 没出现，往往不是少写了一行配置，而是某个注解、某个依赖、甚至某行测试代码，悄悄改写了条件判断的上下文。盯住自动配置报告，比翻十遍文档都管用。
