Maven Jandex插件无法为本地自定义仓库生成索引的问题排查

1. 让Jandex插件自动触发索引生成 #

部分模块（如entity）执行mvn clean install时不生成索引，是因为插件未绑定到Maven生命周期阶段，仅手动执行目标才会触发。解决方法是在需要生成索引的模块pom.xml中，将Jandex插件绑定到process-classes阶段：

<build>
    <plugins>
        <plugin>
            <groupId>org.jboss.jandex</groupId>
            <artifactId>jandex-maven-plugin</artifactId>
            <version>3.1.2</version> <!-- 建议使用最新稳定版本 -->
            <executions>
                <execution>
                    <id>generate-jandex-index</id>
                    <goals>
                        <goal>jandex</goal>
                    </goals>
                    <phase>process-classes</phase> <!-- 绑定到编译后阶段，install时自动执行 -->
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

如果是多模块项目，建议把这段配置放到父pom的pluginManagement节点中，子模块直接继承，避免重复配置。配置完成后，执行mvn clean install时，所有继承该配置的模块都会自动生成META-INF/jandex.idx文件并打包到jar中。

2. 消除跨模块手动索引配置 #

Project B无需手动配置索引Project A，只要Project A正确生成了Jandex索引，Quarkus会自动读取依赖jar中的META-INF/jandex.idx文件。需要确认两点：

• Project A的pom.xml已正确配置Jandex插件，执行mvn install后，target/classes/META-INF/下存在jandex.idx文件，且最终打包的jar中包含该文件。
• Project B对Project A的依赖配置正常，没有通过<exclusions>排除META-INF目录。

3. 解决application.properties覆盖问题 #

多层依赖中同key的配置会被上层模块覆盖，可通过以下方式处理：

• 拆分配置职责：子模块（如Project A、B）的application.properties仅存放模块专属配置，全局核心配置统一放到最上层的应用模块（Project C）中。
• 使用自定义前缀：给子模块的配置添加专属前缀，比如Project B的配置用quarkus.module-b.xxx，Project C用quarkus.module-c.xxx，避免key冲突。
• 指定额外配置文件：在应用模块的application.properties中配置quarkus.config.locations，引入子模块的独立配置文件，比如：

  quarkus.config.locations=classpath:module-b.properties,classpath:module-a.properties
  

  子模块将配置写到对应的module-a.properties、module-b.properties中，避免与主配置文件冲突。

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