Spring Boot无法加载环境特定配置文件问题排查

看起来你在Spring Boot独立应用中加载环境特定配置时踩了几个常见的坑，我来帮你梳理下问题和解决办法：

问题根源分析 #

1. 手动创建PropertyPlaceholderConfigurer冲突：Spring Boot已经自动配置了PropertySourcesPlaceholderConfigurer来处理属性占位符，手动定义这个Bean会和自动配置的实例冲突，导致属性无法正确解析。
2. @Bean方法返回类型错误：你的Config类中getProperty()方法返回类型是void，这不符合Spring @Bean的规范——@Bean方法必须返回要注册的Bean类型，否则Spring无法正确创建和管理这个Bean，也会间接影响属性注入。
3. 错误的应用启动方式：使用AnnotationConfigApplicationContext启动Spring Boot应用，没有触发Spring Boot完整的自动配置流程，包括属性加载的自动配置逻辑，导致环境配置无法被正确加载。

修正后的代码示例 #

1. 简化环境配置类（DevConfig.java）

放弃手动配置PropertyPlaceholderConfigurer，改用Spring Boot原生的配置加载方式：

@Configuration
@Profile("dev")
// 如果你的配置文件在resources/dev/application-dev.properties，用这个注解指定路径
@PropertySource("classpath:dev/application-dev.properties")
public class DevConfig {
    // 无需额外代码，Spring Boot会自动处理属性加载
}

小提示：如果把配置文件重命名为application-dev.properties放在resources根目录，连@PropertySource都可以省略——Spring Boot会根据激活的profile自动加载对应命名的配置文件。

2. 修正主配置类（Config.java）

修复@Bean方法的返回类型错误，简化注解：

@SpringBootApplication
@ComponentScan(basePackages="com.my.package")
// 不需要手动Import环境配置类，@SpringBootApplication会自动扫描同包及子包的配置类
public class Config {

    @Value("${someProperty}")
    private String property;

    @Bean
    public String getProperty() { // 这里返回类型改为String，和属性类型一致
        return property;
    }

    // other beans
}

3. 正确启动Spring Boot应用（Main.java）

使用SpringApplication启动，激活对应的dev profile：

public class Main {
    public static void main(String args[]) {
        // 方式1：代码中指定激活dev profile
        SpringApplication app = new SpringApplication(Config.class);
        app.setAdditionalProfiles("dev");
        ApplicationContext context = app.run(args);

        // 方式2：通过启动参数指定（推荐，更灵活）
        // SpringApplication.run(Config.class, "--spring.profiles.active=dev");

        SomeBean bean = context.getBean("beanName", SomeBean.class);
        // logic follows
    }
}

额外注意事项 #

• 确保dev/application-dev.properties文件确实存在于resources目录下，路径和文件名拼写无误。
• 如果需要多个环境（dev/qa），可以为每个环境创建对应的配置类并添加@Profile注解，Spring会根据激活的profile加载对应的配置。

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