SpringBoot 2.7.6中RedisTemplate无法被Spring自动装配求助

同一个配置类中定义的RestTemplate可被Spring正常管理，但RedisTemplate无法被识别，应用启动时报错：

Field redisTemplate in com.school.repair.common.HttpRequestUtils required a bean of type 'org.springframework.data.redis.core.RedisTemplate' that could not be found.

配置类代码：

@Configuration
public class SpringBeanConfig {

    @Bean
    public RestTemplate restTemplate() throws NoSuchAlgorithmException, KeyStoreException, KeyManagementException {
        SSLContext sslContext = new SSLContextBuilder()
                .loadTrustMaterial(null, (certificate, authType) -> true)
                .build();

        CloseableHttpClient httpClient = HttpClients.custom()
                .setSslcontext(sslContext)
                .setSSLHostnameVerifier(NoopHostnameVerifier.INSTANCE)
                .build();

        HttpComponentsClientHttpRequestFactory requestFactory = new HttpComponentsClientHttpRequestFactory();
        requestFactory.setHttpClient(httpClient);
        return new RestTemplate(requestFactory);
    }

    @Bean
    public RedisTemplate<String, Serializable> redisTemplate(RedisConnectionFactory redisConnectionFactory){
        RedisTemplate<String,Serializable> redisTemplate = new RedisTemplate<>();
        //配置序列化器 以下均是
        redisTemplate.setConnectionFactory(redisConnectionFactory);
        redisTemplate.setKeySerializer(RedisSerializer.string());
        redisTemplate.setValueSerializer(RedisSerializer.json());
        redisTemplate.setHashKeySerializer(RedisSerializer.string());
        redisTemplate.setHashValueSerializer(RedisSerializer.java());
        return redisTemplate;
    }

}

依赖配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
</dependency>

1. 修正泛型匹配问题 #

你定义的RedisTemplate是带泛型的RedisTemplate<String, Serializable>，但注入时如果直接使用无泛型的RedisTemplate，Spring类型匹配机制可能无法识别，可采用两种方式处理：

• 方式一：注入时指定泛型
  在HttpRequestUtils中修改注入类型：

  @Autowired
  private RedisTemplate<String, Serializable> redisTemplate;
  

• 方式二：用@Qualifier指定Bean名称
  保持注入的RedisTemplate无泛型，添加@Qualifier注解指定Bean默认名称（方法名redisTemplate）：

  @Autowired
  @Qualifier("redisTemplate")
  private RedisTemplate redisTemplate;
  

2. 确认RedisConnectionFactory Bean存在 #

RedisTemplate依赖RedisConnectionFactory，若Spring未自动创建该Bean，会导致RedisTemplate初始化失败：

• 检查application.properties/application.yml中的Redis配置是否正确，示例：

  spring.redis.host=你的Redis地址
  spring.redis.port=6379
  # 有密码时需配置
  # spring.redis.password=你的Redis密码
  

• 确认主启动类未排除RedisAutoConfiguration，若@SpringBootApplication注解中有exclude参数，检查是否包含RedisAutoConfiguration.class，如有则移除该排除项。

3. 确保配置类被Spring扫描 #

检查SpringBeanConfig所在包是否在Spring扫描范围内：

• @SpringBootApplication默认扫描主启动类所在包及其子包，若配置类不在该范围，可：
  • 将SpringBeanConfig移至主启动类所在包或其子包下；
  • 或在主启动类添加@ComponentScan指定配置类所在包：

    @SpringBootApplication
    @ComponentScan(basePackages = {"你的主包路径", "com.school.repair.config"})
    public class YourApplication {
        public static void main(String[] args) {
            SpringApplication.run(YourApplication.class, args);
        }
    }
    

4. 排查多RedisTemplate Bean冲突 #

若项目中存在其他RedisTemplate Bean，Spring无法确定注入实例，可给你的RedisTemplate指定唯一名称：

@Bean(name = "customRedisTemplate")
public RedisTemplate<String, Serializable> redisTemplate(RedisConnectionFactory redisConnectionFactory){
    // 原代码逻辑不变
}

注入时通过@Qualifier("customRedisTemplate")指定该名称即可。

内容的提问来源于stack exchange，提问作者Xin Gao