使用@Autowired 註入RedisTemplate報錯的問題及解決

Posted on by

@Autowired 註入RedisTemplate報錯

先看報錯信息

Field redisTemplate in xxx.xxx required a bean of type 'org.springframework.data.redis.core. RedisTemplate' that could not be found.

The injection point has the following annotations:

​     @org.springframework.beans.factory.annotation.Autowired(required=true)

下面是Redis配置類

@Configuration
public class RedisConfig {

    @Bean
    public RedisTemplate<String, Object> redisTemplate(LettuceConnectionFactory lettuceConnectionFactory) {
        // 設置序列化
        Jackson2JsonRedisSerializer<Object> jackson2JsonRedisSerializer = new Jackson2JsonRedisSerializer<>(Object.class);
        ObjectMapper om = new ObjectMapper();
        om.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.ANY);
        om.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL);
        jackson2JsonRedisSerializer.setObjectMapper(om);
        // 配置redisTemplate
        RedisTemplate<String, Object> redisTemplate = new RedisTemplate<>();
        redisTemplate.setConnectionFactory(lettuceConnectionFactory);
        RedisSerializer<?> stringSerializer = new StringRedisSerializer();
        redisTemplate.setKeySerializer(stringSerializer);// key序列化
        redisTemplate.setValueSerializer(jackson2JsonRedisSerializer);// value序列化
        redisTemplate.setHashKeySerializer(stringSerializer);// Hash key序列化
        redisTemplate.setHashValueSerializer(jackson2JsonRedisSerializer);// Hash value序列化
        redisTemplate.afterPropertiesSet();
        return redisTemplate;
    }
}

下面是註入方式

   @Autowired
    private RedisTemplate<String, Object> redisTemplate;

解決方法一

將@Autowired改為 @Resource

   @Resource
    private RedisTemplate<String, Object> redisTemplate;

解決方法二

去掉泛型

@Autowired
private RedisTemplate redisTemplate;

下面咱們來看一下原因

首先我們需要瞭解@Autowired和@Resource的區別

他們的共同點

@Resource和@Autowired都是做bean的註入時使用的。

不同點

  • Autowired默認是按照類型裝配註入的，默認情況下它要求依賴對象必須存在
  • Resource默認是按照名稱來裝配註入的，隻有當找不到與名稱匹配的bean才會按照類型來裝配註入

由於Autowired是根據類型來裝配註入的，所以泛型也被考慮進去瞭，所以它會去spring容器中找 RedisTemplate<String, Object> 這個bean ；

String[] beanDefinitionNames = run.getBeanDefinitionNames();
System.out.println(Arrays.toString(beanDefinitionNames));

通過代碼獲取到spring容器中所有的bean ，控制臺打印redisTemplate 所以無法找到對應的bean

@Autowired 註入RedisTemplate為null

最近使用Springboot引入redis，直接在Service裡使用@Autowired 註入RedisTemplate，但是啟動時發現註入的@RedisTemplate為null

@Service
public class CacheRedisImpl implements Cache {

    @Autowired(required = false)
    private RedisTemplate<String,Object> redisTemplate;
	....    
}

上述代碼運行啟動之後斷點，如下圖，無論如何都是null

這裡無論如何都就是null

最後去查閱spring的源碼 RedisAutoConfiguration（在org.springframework.boot.autoconfigure.data.redis包）

@Configuration
@ConditionalOnClass(RedisOperations.class)
@EnableConfigurationProperties(RedisProperties.class)
@Import({ LettuceConnectionConfiguration.class, JedisConnectionConfiguration.class })
public class RedisAutoConfiguration {

	@Bean
	@ConditionalOnMissingBean(name = "redisTemplate")
	public RedisTemplate<Object, Object> redisTemplate(
			RedisConnectionFactory redisConnectionFactory) throws UnknownHostException {
		RedisTemplate<Object, Object> template = new RedisTemplate<>();
		template.setConnectionFactory(redisConnectionFactory);
		return template;
		}
		...

終於發現問題瞭，spring註入的是RedisTemplate<Object, Object>

而我註入的泛型是RedisTemplate<String,Object>。

解決

通過上述排查分析，解決方案有如下

1.@Autowired 時使用RedisTemplate<Object, Object> 或RedisTemplate

@Service
public class CacheRedisImpl implements Cache {
    @Autowired(required = false)
    private RedisTemplate redisTemplate;

運行效果如下圖：

2.如一定要使用RedisTemplate<String,Object>，寫一個Configuration自行手動註入@Bean

@Configuration
public class RedisAutoConfig {
    @Bean(name = "redisTemplate4String")
    public RedisTemplate<String,Object> redisTemplate4String(RedisConnectionFactory redisConnectionFactory){
        RedisTemplate<String,Object> redisTemplate = new RedisTemplate<>();
        redisTemplate.setConnectionFactory(redisConnectionFactory);

        return  redisTemplate;
    }
}

效果如下：

PS: 其實細心的童鞋可能會發現我的代碼裡@Autowired配置是(required = false)。如果去掉的話，springboot 啟動裡會直接報錯找不到bean。解決方案與本文類似。

以上為個人經驗，希望能給大傢一個參考，也希望大傢多多支持WalkonNet。

推薦閱讀：