Quarkus项目中如何合并依赖模块的多个application.properties文件？

方案1：开发Quarkus扩展（推荐原生方式） #

如果要给所有Quarkus项目统一提供默认配置和功能，最规范的做法是开发自定义Quarkus扩展：

• 扩展中通过@ConfigMapping定义配置接口，直接声明默认值，无需单独的application.properties文件，Quarkus会自动识别这些默认配置。
• 若必须使用application.properties文件，可将其打包在扩展的META-INF/quarkus-application.properties路径下。Quarkus会自动加载该文件作为默认配置，且优先级低于应用自身的application.properties，天然实现“应用配置覆盖默认配置”的效果，无需手动合并。

方案2：Maven构建时合并配置 #

通过maven-resources-plugin实现所有依赖Jar与应用自身的application.properties合并，且应用配置追加到末尾：

1. 先执行mvn dependency:copy-dependencies将所有依赖Jar解压到target/dependency目录。
2. 在pom.xml中添加插件配置：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-resources-plugin</artifactId>
    <version>3.3.1</version>
    <executions>
        <execution>
            <id>merge-application-properties</id>
            <phase>process-resources</phase>
            <goals>
                <goal>copy-resources</goal>
            </goals>
            <configuration>
                <outputDirectory>${project.build.outputDirectory}</outputDirectory>
                <resources>
                    <!-- 先合并所有依赖中的application.properties -->
                    <resource>
                        <directory>${project.build.directory}/dependency</directory>
                        <includes>
                            <include>**/application.properties</include>
                        </includes>
                        <filtered>true</filtered>
                    </resource>
                    <!-- 最后追加应用自身的配置，同键会覆盖前面的 -->
                    <resource>
                        <directory>${project.basedir}/src/main/resources</directory>
                        <includes>
                            <include>application.properties</include>
                        </includes>
                        <filtered>true</filtered>
                    </resource>
                </resources>
                <overwrite>false</overwrite>
                <append>true</append>
            </configuration>
        </execution>
    </executions>
</plugin>

方案3：Gradle构建时合并配置 #

自定义Gradle任务实现类似Shadow插件的合并逻辑，确保应用配置优先级最高：

task mergeApplicationProperties {
    dependsOn configurations.runtimeClasspath
    def outputFile = file("$buildDir/resources/main/application.properties")
    
    doLast {
        // 收集所有依赖中的application.properties文件
        def propsFiles = configurations.runtimeClasspath.files.collect { file ->
            file.isDirectory() ? fileTree(file).include("**/application.properties").files : zipTree(file).include("**/application.properties").files
        }.flatten()
        
        // 添加项目自身的配置文件到最后
        propsFiles.add(file("$projectDir/src/main/resources/application.properties"))
        
        // 合并配置，后面加载的配置会覆盖前面的同键
        def mergedProps = new Properties()
        propsFiles.each { propFile ->
            if (propFile.exists()) propFile.withInputStream { mergedProps.load(it) }
        }
        
        // 写入最终合并后的文件
        outputFile.parentFile.mkdirs()
        mergedProps.store(outputFile.newWriter(), "Merged application.properties")
    }
}

// 让资源处理任务依赖合并任务
processResources.dependsOn mergeApplicationProperties

关键注意点 #

• 优先选择Quarkus扩展方案，完全契合Quarkus的配置加载机制，同时能封装默认功能（如你提到的过滤器）。
• 构建时合并方案中，Properties类会自动用后加载的配置覆盖前序同键配置，正好满足“应用配置最终生效”的需求。
• 多依赖场景下，合并顺序会遵循依赖声明顺序，最后加载应用自身配置。

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