自定义Spring Boot Starter无法加载Profile配置文件求助

以下是几个排查和解决方向，按优先级尝试：

• 确认Starter配置文件路径与打包配置
  Starter中的application-dev.yml、application-prom.yml必须放在src/main/resources根目录下，不能放在子文件夹里。同时检查Maven/Gradle的打包配置，确保这些文件被正确打包进Starter的jar包——你已经用jar tf确认存在，这一步可以快速过，但如果是Gradle项目，要确保sourceSets.main.resources包含这些文件。

• 检查主应用Profile激活的有效性
  虽然你用了VM参数-Dspring.profiles.active=dev，但可以在主应用的启动类里加一行代码验证当前激活的Profile：

  @SpringBootApplication
  public class MainApp {
      public static void main(String[] args) {
          ConfigurableApplicationContext context = SpringApplication.run(MainApp.class, args);
          System.out.println("Active Profiles: " + String.join(",", context.getEnvironment().getActiveProfiles()));
      }
  }
  

  确认输出里确实有dev，避免参数没正确传递（比如Idea里VM参数没加到正确的启动配置里）。

• 强制导入Starter的Profile配置文件
  在主应用的application.yml中添加配置，明确导入Starter对应环境的配置：

  spring:
    config:
      import: classpath:/application-${spring.profiles.active}.yml
  

  Spring Boot默认会扫描classpath下的所有application-*.yml，但如果主应用有自定义的配置加载逻辑，或者配置文件优先级被修改，这一步可以强制引入Starter的配置。

• 改用@ConfigurationProperties绑定配置
  不要依赖Spring自动加载application-*.yml，而是在Starter里定义配置类，用@ConfigurationProperties绑定属性，再通过@EnableConfigurationProperties开启：

  @ConfigurationProperties(prefix = "my.starter")
  public class StarterProperties {
      private String foo;
      // getter、setter
  }
  
  @Configuration
  @EnableConfigurationProperties(StarterProperties.class)
  public class StarterAutoConfiguration {
      // 配置逻辑
  }
  

  这种方式更可靠，也符合Spring Boot Starter的最佳实践，避免Profile配置加载的不确定性。

• 排查配置加载优先级与冲突
  主应用的配置会覆盖Starter的配置，但如果Starter的配置根本没被加载，可以通过打印所有加载的配置源来确认：

  @Autowired
  private Environment environment;
  
  @PostConstruct
  public void printPropertySources() {
      MutablePropertySources propertySources = ((AbstractEnvironment) environment).getPropertySources();
      propertySources.forEach(source -> System.out.println("Loaded property source: " + source.getName()));
  }
  

  看看输出里有没有Starter jar中的application-dev.yml对应的源，如果没有，说明文件没被Spring扫描到，回到第一步检查路径和打包。

• 刷新Idea依赖与清理缓存
  有时候Idea的依赖缓存会出问题，试试执行Maven的clean install重新打包Starter，然后在Idea里点击"File -> Invalidate Caches..."清理缓存并重启，再重新运行主应用。

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