解決Spring中@Value注解取值為null問題

更新時(shí)間：2023年08月29日 09:21:45 作者：bboyzqh

近期應(yīng)用中因業(yè)務(wù)迭代需要接入 user 客戶端,接入后總是啟動(dòng)失敗,報(bào)注冊 user bean 依賴的配置屬性為 null,所以接下來小編就和大家一起排查分析這個(gè)問題,感興趣的小伙伴跟著小編一起來看看吧

一、背景

近期應(yīng)用中因業(yè)務(wù)迭代需要接入 user 客戶端，接入后總是啟動(dòng)失敗，報(bào)注冊 user bean 依賴的配置屬性為 null（如 appName，group 等都為空），示例代碼如下：

@Configuration
public class ConsumerBeanConfig {
  @Value("${project.name}")
  private String appName;
  @Value("${spring.hsf.group}")
  private String group;
  @Value("${spring.hsf.version}")
  private String version;
  @Bean
  public UserCommonContext userCommonContext() {
    UserCommonContext commonContext = new UserCommonContext();
    commonContext.setAppName(appName);
    return commonContext;
  }
  @Bean
  public HSFSpringConsumerBean userReadService() {
    HSFSpringConsumerBean consumer = new HSFSpringConsumerBean();
    consumer.setInterfaceClass(UserReadService.class);
    consumer.setVersion(version);
    consumer.setGroup(group);
    return consumer;
  }
  //......
}

二、@Value 取值為 null 原因分析

2.1. @Value 取值為 null 常見原因分析

常見現(xiàn)象一：類沒有交給 Spring 管理，比如類沒有加上 @Component 等注解

錯(cuò)誤案例

// 配置類
public class PeopleConfigValue {
    @Value("${people.name}")
    private String name;
    @Value("${people.age}")
    private String age;
    public PeopleConfigValue() {
    }
    // getter and setter...
}
// 測試類（以下取值為空）
PeopleConfigValue peopleConfigValue = new PeopleConfigValue();
System.out.println("get peopleConfigValue-name value " + peopleConfigValue.getName());
System.out.println("get peopleConfigValue-age value " + peopleConfigValue.getAge());

正常案例

@Component
public class PeopleConfigValue {
    @Value("${people.name}")
    private String name;
    @Value("${people.age}")
    private String age;
    public PeopleConfigValue() {
    }
    // getter and setter...
}
// 測試類（以下取值正常）
PeopleConfigValue peopleConfigValue = SpringContextUtil.getBean(PeopleConfigValue.class);
System.out.println("get peopleConfigValue-name value " + peopleConfigValue.getName());
System.out.println("get peopleConfigValue-age value " + peopleConfigValue.getAge());

常見現(xiàn)象二：手動(dòng) new 對象實(shí)例，沒有從 Spring 容器中獲取

錯(cuò)誤案例

@Component
public class PeopleConfigValue {
    @Value("${people.name}")
    private String name;
    @Value("${people.age}")
    private String age;
    public PeopleConfigValue() {
    }
    // getter and setter...
}
// 測試類（以下取值為空）
PeopleConfigValue peopleConfigValue = new PeopleConfigValue();
System.out.println("get peopleConfigValue-name value " + peopleConfigValue.getName());
System.out.println("get peopleConfigValue-age value " + peopleConfigValue.getAge());

正確案例，參考第一個(gè)現(xiàn)象。

常見現(xiàn)象三：使用 static 或 final 修飾成員變量

使用 static 或 final 修飾成員變量值不可改變，注解無法注入配置值。

錯(cuò)誤案例

@Component
public class PeopleConfigValue {
    @Value("${people.name}")
    private static String name;
    @Value("${people.age}")
    private static String age;
    public PeopleConfigValue() {
    }
    // getter
}
// 測試類（以下取值為空）
PeopleConfigValue peopleConfigValue = SpringContextUtil.getBean(PeopleConfigValue.class);
System.out.println("get peopleConfigValue-name value " + peopleConfigValue.getName());
System.out.println("get peopleConfigValue-age value " + peopleConfigValue.getAge());

正確案例

以下方式不推薦，作為 static 或 final 修飾成員變量值應(yīng)該是不可變的，以下可通過 setter 方式修改值：

@Component
public class PeopleConfigValue {
    private static String name;
    private static String age;
    public PeopleConfigValue() {
    }
    public static String getName() {
        return name;
    }
    @Value("${people.name}")
    public void setName(String nameValue) {
        name = nameValue;
    }
    public static String getAge() {
        return age;
    }
    @Value("${people.age}")
    public void setAge(String ageValue) {
        age = ageValue;
    }
}
// 測試類，取值正常
PeopleConfigValue peopleConfigValue = SpringContextUtil.getBean(PeopleConfigValue.class);
System.out.println("get peopleConfigValue-name value " + peopleConfigValue.getName());
System.out.println("get peopleConfigValue-age value " + peopleConfigValue.getAge());

2.2 案例原因分析

上述案例中 @Value 的使用方式是常規(guī)使用方式，不應(yīng)該出現(xiàn)問題，開始懷疑是與 Spring 應(yīng)用上下文 Bean 的初始化順序有關(guān)，排查這個(gè)問題還是先摸清一下 Spring Boot 的啟動(dòng)原理及 @Value 解析機(jī)制，直接上圖：

圖片箭頭指向即 SpringApplication 啟動(dòng)階段，在這個(gè)過程中進(jìn)行 Bean 的實(shí)例化，進(jìn)一步細(xì)化 SpringApplication 啟動(dòng)流程如下：

眾所周知，應(yīng)用中配置的 bean 在 Spring 啟動(dòng)時(shí)會(huì)全部解析為 BeanDefinition（可視為 bean 的元信息，圖中第 2 步），同時(shí) Spring 提供了 BeanFactoryPostProcessor 接口用于用戶擴(kuò)展（圖中第 5 步，比如在這里可以修改BeanDefinition 的元數(shù)據(jù)），最后在實(shí)例化 bean 過程時(shí)（SpringApplication 啟動(dòng)流程圖中第 11.3 步）會(huì)讀取相應(yīng)的 BeanDefinition 進(jìn)行初始化。

回到 @Value 注解占位符的解析機(jī)制，@Value 注解占位符靠 PropertyResourceConfigurer 來解析（PropertySourcesPlaceholderConfigurer 會(huì)調(diào)用 PropertyResourceConfigurer 解析能力來解析占位符，并存儲(chǔ)到 propertySources 屬性集合中），而 PropertyResourceConfigurer 正是實(shí)現(xiàn)了 BeanFactoryPostProcessor 接口，在 BeanFactory 后處理階段進(jìn)行了占位符替換，且 PropertyResourceConfigurer 的優(yōu)化級最低（這里有個(gè)風(fēng)險(xiǎn)點(diǎn)：任何應(yīng)用依賴的實(shí)現(xiàn) BeanFactoryPostProcessor 接口的 bean 都會(huì)比 PropertyResourceConfigurer 先執(zhí)行）。

理解了 Spring 的啟動(dòng)機(jī)制和 @Value 注解占位符的解析機(jī)制，再排查應(yīng)用代碼發(fā)現(xiàn) UserCommonContext 也實(shí)現(xiàn)了 BeanFactoryPostProcessor 接口，也就是說，出現(xiàn)了下述情況：

由于 UserCommonContext 依賴了 UserBeanConfig，導(dǎo)致 UserBeanConfig 提前初始化，但此時(shí) @Value 中的占位符還未替換，那么 UserBeanConfig 中所有標(biāo)記 @Value 注解屬性都為 null，導(dǎo)致啟動(dòng)失敗。

三、解決方案

上述情況雖然會(huì)導(dǎo)致 UserBeanConfig 中所有標(biāo)記 @Value 注解屬性都為 null，其他 bean 的配置就不要依賴 UserBeanConfig 中標(biāo)記 @Value 注解的屬性即可（不依賴干擾 bean 生命周期）：

@Bean
public HSFSpringConsumerBean userReadService(@Value("${spring.hsf.version}") String version, @Value("${spring.hsf.group}") String group) {
    HSFSpringConsumerBean consumer = new HSFSpringConsumerBean();
    consumer.setInterfaceClass(UserReadService.class);
    consumer.setVersion(version);
    consumer.setGroup(group);
    return consumer;
}

以上就是解決Spring中@Value注解取值為null問題的詳細(xì)內(nèi)容，更多關(guān)于Spring @Value注解取值為null的資料請關(guān)注腳本之家其它相關(guān)文章！

您可能感興趣的文章: