如何在Spring Boot中优先于所有配置与组件加载application.properties

核心原因 #

常规的@Value或@ConfigurationProperties注入空值，大多是因为目标Bean的初始化顺序早于配置属性的绑定时机。比如某些自动配置Bean、CommandLineRunner/ApplicationRunner实现类，会在Spring上下文完全刷新前被实例化，此时配置还未完成绑定。

解决方案 #

方案1：使用EnvironmentPostProcessor扩展点 #

这是Spring Boot官方提供的、最可靠的早期配置加载方式，能在上下文刷新前将配置注入到Environment中，确保所有后续Bean都能获取到属性。

1. 实现EnvironmentPostProcessor接口：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.env.EnvironmentPostProcessor;
import org.springframework.core.env.ConfigurableEnvironment;
import org.springframework.core.env.PropertiesPropertySource;
import org.springframework.core.io.ClassPathResource;

import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;

public class EarlyPropertyLoader implements EnvironmentPostProcessor {
    private static final String PROPERTY_FILE = "application.properties";

    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        try (InputStream inputStream = new ClassPathResource(PROPERTY_FILE).getInputStream()) {
            Properties properties = new Properties();
            properties.load(inputStream);
            // 将自定义配置源添加到最前面，确保优先级最高
            environment.getPropertySources().addFirst(
                new PropertiesPropertySource("early-app-properties", properties)
            );
        } catch (IOException e) {
            throw new RuntimeException("Failed to load " + PROPERTY_FILE + " during early initialization", e);
        }
    }
}

2. 注册处理器：在项目的src/main/resources/META-INF/spring.factories文件中添加以下内容：

org.springframework.boot.env.EnvironmentPostProcessor=com.yourpackage.EarlyPropertyLoader

方案2：在启动类提前加载配置 #

如果场景简单，也可以在SpringApplication.run()之前手动读取配置并设置为默认属性：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

import java.io.IOException;
import java.io.InputStream;
import java.util.Properties;

@SpringBootApplication
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication app = new SpringApplication(YourApplication.class);
        
        // 提前加载application.properties
        Properties defaultProps = new Properties();
        try (InputStream is = YourApplication.class.getResourceAsStream("/application.properties")) {
            defaultProps.load(is);
            app.setDefaultProperties(defaultProps);
        } catch (IOException e) {
            e.printStackTrace();
        }
        
        app.run(args);
    }
}

方案3：修复Bean初始化顺序（针对特定组件） #

如果只有个别Bean出现空值，可以强制让它依赖于配置绑定的Bean：

• 对于用@ConfigurationProperties的配置类，确保它被标记为@Configuration或通过@EnableConfigurationProperties启用。
• 在出现空值的Bean上添加@DependsOn("yourConfigBeanName")，确保配置Bean先初始化。

注意事项 #

• 若使用多环境配置（如application-dev.properties），在EnvironmentPostProcessor中需要根据当前激活的Profile加载对应文件，可通过environment.getActiveProfiles()获取激活的Profile。
• 避免在static代码块中读取Spring管理的配置——static块在类加载时执行，此时Spring上下文尚未初始化，必然获取到空值。

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