Spring Boot多Jar包场景下如何加载各自的application.properties

问题根源 #

Spring Boot默认仅会加载classpath下的单个application.properties/application.yml文件，当多个依赖Jar包中存在同名配置文件时，加载顺序由依赖解析顺序决定（取决于Maven/Gradle的依赖排序逻辑），这就导致你的Demo2配置覆盖了Demo1和Demo3的配置。

针对性解决方案 #

方案1：重命名配置文件+显式指定加载（快速解决） #

给每个模块的配置文件单独命名避免重名，再通过注解指定加载对应文件：

• Demo1保留原application.properties（配置MySQL）
• Demo2配置文件改为application-demo2.properties（配置Oracle）
• Demo3配置文件改为application-demo3.properties（配置MongoDB）

在每个模块的配置类上添加@PropertySource注解：

// Demo2的Oracle配置类
@Configuration
@PropertySource("classpath:application-demo2.properties")
public class OracleConfig {
    // Oracle数据源配置逻辑
}

// Demo3的MongoDB配置类
@Configuration
@PropertySource("classpath:application-demo3.properties")
public class MongoConfig {
    // MongoDB客户端配置逻辑
}

Demo1的主配置会被默认加载，无需额外修改。

方案2：配置前缀隔离+@ConfigurationProperties（规范扩展） #

给每个模块的配置添加专属前缀，通过@ConfigurationProperties绑定，彻底避免键冲突：

• Demo1的MySQL配置：demo1.mysql.url=xxx、demo1.mysql.username=xxx
• Demo2的Oracle配置：demo2.oracle.url=xxx、demo2.oracle.username=xxx
• Demo3的MongoDB配置：demo3.mongo.uri=xxx、demo3.mongo.database=xxx

每个模块的配置类使用前缀绑定：

// Demo2的Oracle配置类
@Configuration
@ConfigurationProperties(prefix = "demo2.oracle")
public class OracleConfig {
    private String url;
    private String username;
    // getter/setter
}

// Demo3的MongoDB配置类
@Configuration
@ConfigurationProperties(prefix = "demo3.mongo")
public class MongoConfig {
    private String uri;
    private String database;
    // getter/setter
}

这种方式适合后续扩展N个Jar包的场景，只要新模块遵循前缀规范，配置就不会互相干扰。

方案3：自定义EnvironmentPostProcessor（自动扫描加载N个Jar包） #

如果后续要批量引入N个Jar包，且希望无需手动修改配置类，可实现Spring Boot的EnvironmentPostProcessor接口，自动扫描加载约定格式的配置文件：

1. 约定模块配置文件命名规则：application-module-{moduleName}.properties（如Demo2为application-module-demo2.properties）
2. 编写自定义配置加载处理器：

public class ModuleConfigLoader implements EnvironmentPostProcessor {
    private final PropertiesPropertySourceLoader loader = new PropertiesPropertySourceLoader();

    @Override
    public void postProcessEnvironment(ConfigurableEnvironment environment, SpringApplication application) {
        try {
            // 扫描classpath下所有符合约定的配置文件
            Resource[] resources = new PathMatchingResourcePatternResolver()
                .getResources("classpath:application-module-*.properties");
            
            for (Resource resource : resources) {
                // 加载配置并添加到环境中
                List<PropertySource<?>> sources = loader.load(resource.getFilename(), resource);
                sources.forEach(source -> environment.getPropertySources().addLast(source));
            }
        } catch (IOException e) {
            throw new IllegalStateException("Failed to load module configuration files", e);
        }
    }
}

3. 在src/main/resources/META-INF/spring.factories中注册处理器：

org.springframework.boot.env.EnvironmentPostProcessor=com.example.demo1.config.ModuleConfigLoader

后续新增Jar包时，只要配置文件遵循命名规则，就会被自动加载，无需修改Demo1代码。

注意事项 #

• 确保Maven/Gradle打包时，模块src/main/resources下的配置文件已正确打入Jar包
• 若多个配置文件存在相同键，后加载的配置会覆盖先加载的，可通过调整addLast/addFirst控制优先级

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