SpringBoot：将application.properties配置注入配置类并解决空值与竞态问题

问题根源 #

1. static final字段无法被@Value注入：Spring的依赖注入针对实例对象，static属于类级别，Spring不会处理静态字段的注入，所以你定义的URI始终是空字符串。
2. 非static字段注入出现竞态：移除static后用@Autowired注入MyConfig时，若使用该配置的Bean（比如WebClient相关组件）比MyConfig先初始化，就会出现属性还未赋值的情况。

方案一：使用@ConfigurationProperties（官方推荐） #

这是Spring Boot官方主推的类型安全配置绑定方式，能彻底避免竞态问题，还支持复杂配置结构。

1. 编写配置类
   绑定application.properties中的属性，注意前缀和属性名对应：

@ConfigurationProperties(prefix = "app") // 假设你的配置项是app.endpoint
public class MyConfig {
    private String endpoint;

    // 必须提供getter和setter，Spring通过它们完成属性绑定
    public String getEndpoint() {
        return endpoint;
    }

    public void setEndpoint(String endpoint) {
        this.endpoint = endpoint;
    }
}

2. 开启配置绑定
   在启动类或任意配置类上添加注解，启用配置类的属性绑定：

@SpringBootApplication
@EnableConfigurationProperties(MyConfig.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 注入并使用配置
   用构造方法注入MyConfig（Spring会保证依赖先初始化）：

@Component
public class YourWebClientService {
    private final WebClient webClient;
    private final MyConfig myConfig;

    // 构造方法注入，避免竞态
    public YourWebClientService(WebClient webClient, MyConfig myConfig) {
        this.webClient = webClient;
        this.myConfig = myConfig;
    }

    public Flux<Event> fetchEvents() {
        return this.webClient.get()
                .uri(uriBuilder -> uriBuilder.path(myConfig.getEndpoint()).build())
                .accept(MediaType.TEXT_EVENT_STREAM)
                .exchangeToFlux(e -> e.bodyToFlux(Event.class));
    }
}

方案二：修正@Value注入方式（适合简单场景） #

如果不想用@ConfigurationProperties，可以通过构造方法注入@Value来解决竞态：

1. 修改配置类
   去掉static，用构造方法直接注入属性，确保Bean创建时就完成赋值：

@Configuration
@PropertySource("classpath:application.properties")
public class MyConfig {
    private final String uri;

    // 构造方法注入@Value，Spring初始化Bean时直接赋值
    public MyConfig(@Value("${endpoint}") String uri) {
        this.uri = uri;
    }

    public String getUri() {
        return uri;
    }
}

2. 注入并使用
   同样用构造方法注入MyConfig：

@Component
public class YourWebClientService {
    private final WebClient webClient;
    private final MyConfig myConfig;

    public YourWebClientService(WebClient webClient, MyConfig myConfig) {
        this.webClient = webClient;
        this.myConfig = myConfig;
    }

    public Flux<Event> fetchEvents() {
        return this.webClient.get()
                .uri(uriBuilder -> uriBuilder.path(myConfig.getUri()).build())
                .accept(MediaType.TEXT_EVENT_STREAM)
                .exchangeToFlux(e -> e.bodyToFlux(Event.class));
    }
}

关键说明 #

• 构造方法注入是Spring官方推荐的依赖注入方式，能保证依赖的Bean优先初始化，从根源上避免竞态问题。
• @ConfigurationProperties支持配置校验、复杂嵌套属性等功能，比@Value更适合生产环境的配置管理。

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