WildFly Maven Plugin可执行Jar多模块部署及JPA实体识别问题

一、解决WeldStartService启动ArrayIndexOutOfBoundsException异常 #

maven-shade/assembly插件打包时会合并所有依赖字节码，破坏了WildFly Bootable Jar的类加载隔离机制，打乱了Weld内部类结构，最终导致启动时数组越界。

放弃自定义打包插件，改用WildFly官方提供的wildfly-bootable-jar-maven-plugin构建bootable jar，该插件严格遵循WildFly打包规范，能保证类加载和依赖结构的正确性。

pom.xml配置示例：

<plugin>
    <groupId>org.wildfly.plugins</groupId>
    <artifactId>wildfly-bootable-jar-maven-plugin</artifactId>
    <version>6.2.1.Final</version> <!-- 使用对应JDK的最新稳定版 -->
    <executions>
        <execution>
            <goals>
                <goal>package</goal>
            </goals>
        </execution>
    </executions>
    <configuration>
        <jdkVersion>17</jdkVersion> <!-- 匹配你的项目JDK版本 -->
        <layers>
            <layer>cdi</layer>
            <layer>jpa</layer>
            <!-- 按需添加业务需要的WildFly层，如ejb、transactions等 -->
        </layers>
        <modules>
            <!-- 引入你的内部模块依赖 -->
            <module>com.yourcompany:your-internal-module:1.0.0</module>
        </modules>
    </configuration>
</plugin>

注意：启动类需添加@ApplicationScoped或@Startup注解，确保符合CDI规范，通过WildFly的Main类启动bootable jar。

二、解决WAR包下JPA无法自动识别实体类的问题 #

WAR包结构下，JPA默认仅扫描当前WEB-INF/classes下的实体类，若实体类存在于其他依赖模块中，需显式配置扫描范围。

方案1：开启自动扫描 #

修改persistence.xml，添加<exclude-unlisted-classes>false</exclude-unlisted-classes>，让JPA自动扫描所有可见的实体类：

<persistence-unit name="yourPU" transaction-type="JTA">
    <jta-data-source>java:jboss/datasources/YourDS</jta-data-source>
    <exclude-unlisted-classes>false</exclude-unlisted-classes>
    <!-- 其他JPA配置 -->
</persistence-unit>

方案2：显式指定实体所在Jar包 #

若自动扫描不生效，直接指定包含实体类的依赖Jar：

<persistence-unit name="yourPU" transaction-type="JTA">
    <jta-data-source>java:jboss/datasources/YourDS</jta-data-source>
    <jar-file>WEB-INF/lib/your-entity-module-1.0.0.jar</jar-file>
    <!-- 多个实体模块可添加多个<jar-file>标签 -->
    <!-- 其他JPA配置 -->
</persistence-unit>

方案3：CDI注解扫描 #

在启动类上添加@EntityScan注解指定实体包路径：

@Startup
@ApplicationScoped
@EntityScan(basePackages = "com.yourcompany.entities")
public class YourStartupBean {
    // 启动逻辑代码
}

同时确保实体类已添加@Entity注解，且在类路径范围内。

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