EAP 7：忽略或排除第三方库MANIFEST.MF中的依赖项

以下几种方法可帮你强制忽略第三方库MANIFEST.MF中的Dependencies条目，或彻底排除JBoss自带模块的干扰：

1. 全局禁用Manifest依赖解析（最直接） #

在jboss-deployment-structure.xml中添加配置，让JBoss完全跳过读取WAR包内所有第三方库的Manifest依赖声明：

<jboss-deployment-structure>
    <deployment>
        <!-- 核心配置：禁用所有Manifest中的依赖解析 -->
        <exclude-manifest-dependencies>true</exclude-manifest-dependencies>
        <!-- 额外排除可能残留的JBoss系统模块 -->
        <exclusions>
            <module name="要排除的模块全名" />
            <!-- 示例：<module name="com.fasterxml.jackson.core.jackson-databind" /> -->
        </exclusions>
        <!-- 确保本地WAR包内的类优先加载 -->
        <local-last>false</local-last>
    </deployment>
</jboss-deployment-structure>

之前排除未生效大概率是缺少<exclude-manifest-dependencies>true</exclude-manifest-dependencies>，这个配置会直接阻断JBoss处理第三方库Manifest里的依赖条目。

2. 针对特定JAR精准禁用Manifest依赖 #

如果不想全局禁用，可单独对WAR内的冲突第三方库做配置：

<jboss-deployment-structure>
    <deployment>
        <exclusions>
            <module name="冲突的系统模块名称" />
        </exclusions>
    </deployment>
    <!-- 针对WAR/lib下的特定JAR禁用Manifest依赖 -->
    <sub-deployment name="lib/冲突的第三方库.jar">
        <exclude-manifest-dependencies>true</exclude-manifest-dependencies>
    </sub-deployment>
</jboss-deployment-structure>

注意替换冲突的第三方库.jar为实际文件名。

3. 构建阶段自动清理第三方库的Manifest依赖 #

无需手动修改第三方库，可通过Maven/Gradle在打包时自动移除其Manifest中的Dependencies条目：

• Maven配置（用shade插件重打包）：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-shade-plugin</artifactId>
    <version>3.4.1</version>
    <executions>
        <execution>
            <phase>package</phase>
            <goals>
                <goal>shade</goal>
            </goals>
            <configuration>
                <filters>
                    <filter>
                        <artifact>*:*</artifact>
                        <excludes>
                            <exclude>META-INF/MANIFEST.MF</exclude>
                        </excludes>
                    </filter>
                </filters>
                <transformers>
                    <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                        <!-- 自定义Manifest内容，避免保留原依赖 -->
                    </transformer>
                </transformers>
            </configuration>
        </execution>
    </executions>
</plugin>

这种方式从根源上消除了Manifest依赖问题，无需调整JBoss配置。

4. 强制类加载策略为Parent-Last #

若上述方法仍有问题，可让JBoss优先加载WAR包内的类，而非系统模块：

<jboss-deployment-structure>
    <deployment>
        <classloading>
            <loader-repository>
                com.example:archive=你的WAR包名称.war
                <loader-repository-config>java2ParentDelegation=false</loader-repository-config>
            </loader-repository>
        </classloading>
    </deployment>
</jboss-deployment-structure>

java2ParentDelegation=false会让类加载器先从本地WAR包查找类，找不到再去系统模块中查找，彻底规避自带模块的干扰。

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