非Bean类使用appconfig.properties时@Value注入baseUrl为空的解决方法

问题场景 #

使用Java 11、Spring Framework 5.3.19，代码如下：

public final class Class1 implements Interface1
{
   @Value("${test.url}")
   private String baseUrl;
  // 该URL在不同环境下取值不同

  public Class1(ClassC2 c2, ClassC3 c3) {
  // 一些初始化代码
  }

}

但baseUrl始终为null，无法从appconfig.properties中读取属性值。

原因分析 #

1. Class1未被Spring管理：如果类没有被标记为Spring Bean（无@Component/@Service等注解，也未在配置类中通过@Bean声明），Spring不会对其执行依赖注入，@Value注解完全失效。
2. 字段注入时机滞后：字段注入是在Bean实例化（构造器执行）之后完成的，如果构造器中需要使用baseUrl，此时访问会得到null。
3. 属性文件未加载：appconfig.properties未被Spring正确加载，导致${test.url}无法解析为具体值。

解决方案 #

1. 将Class1声明为Spring管理的Bean #

在类上添加Spring组件注解，示例：

@Component
public final class Class1 implements Interface1 {
    // 原有代码
}

或在配置类中通过@Bean声明：

@Configuration
public class AppConfig {
    @Bean
    public Class1 class1(ClassC2 c2, ClassC3 c3) {
        return new Class1(c2, c3);
    }
}

2. 改用构造器注入（推荐） #

构造器注入是Spring官方推荐的方式，尤其适配不可变类（final类），能保证属性在Bean实例化时就完成注入，彻底避免null问题。修改代码如下：

public final class Class1 implements Interface1 {
    private final String baseUrl;

    public Class1(ClassC2 c2, ClassC3 c3, @Value("${test.url}") String baseUrl) {
        this.baseUrl = baseUrl;
        // 原有初始化代码
    }
}

3. 确保属性文件被Spring加载 #

纯Spring Framework环境下，在配置类上添加@PropertySource注解指定属性文件路径：

@Configuration
@PropertySource("classpath:appconfig.properties")
public class AppConfig {
    // Bean配置代码
}

Spring Boot环境下，只需将appconfig.properties放在src/main/resources目录下，或通过spring.config.additional-location配置路径，Spring Boot会自动加载。

4. 禁止手动实例化Bean #

不要通过new Class1(c2, c3)手动创建实例，必须通过Spring容器获取Bean（如applicationContext.getBean(Class1.class)），否则Spring无法执行属性注入。

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