Java EAR模块类路径冲突：如何让WAR仅使用自身Lib库？

当然可行！这是Java EAR部署中很常见的类路径隔离需求，下面给你梳理几种靠谱的实现方案，具体选哪种要看你使用的应用服务器：

1. 利用应用服务器的类加载隔离配置 #

不同应用服务器都提供了类加载优先级的配置，让WAR优先加载自身WEB-INF/lib的库，甚至完全排除EAR级别的共享库：

• WildFly/EAP：在WAR的WEB-INF/jboss-deployment-structure.xml中配置排除规则，示例：

  <jboss-deployment-structure>
      <deployment>
          <!-- 排除EAR lib下的所有共享库 -->
          <exclusions>
              <module name="deployment.your-ear-name.ear.lib" />
          </exclusions>
          <!-- 设置类加载顺序：优先使用自身库 -->
          <local-last value="false" />
      </deployment>
  </jboss-deployment-structure>
  

  如果只想排除冲突的特定JAR，也可以单独指定对应的模块名称。

• WebLogic：在WAR的WEB-INF/weblogic.xml中开启prefer-web-inf-classes参数，强制优先加载自身库：

  <weblogic-web-app>
      <container-descriptor>
          <prefer-web-inf-classes>true</prefer-web-inf-classes>
      </container-descriptor>
  </weblogic-web-app>
  

• WebSphere：部署时将该WAR的类加载顺序设置为“父类最后”（Parent Last），或者在WEB-INF/ibm-web-bnd.xml中配置更细粒度的隔离规则。

2. 调整EAR的application.xml配置 #

默认情况下EAR的lib目录是所有模块共享的，但你可以给目标WAR单独指定类路径，切断它与EAR共享库的关联：

<application xmlns="http://xmlns.jcp.org/xml/ns/javaee" version="7">
    <!-- 目标WAR模块 -->
    <module>
        <web>
            <web-uri>your-conflicting-war.war</web-uri>
            <context-root>/your-app</context-root>
        </web>
        <!-- 指定仅使用自身WEB-INF/lib的库 -->
        <class-path>WEB-INF/lib/*</class-path>
    </module>

    <!-- 其他模块 -->
    <module>
        <!-- ... -->
    </module>

    <!-- 全局共享库目录 -->
    <library-directory>lib</library-directory>
</application>

注意：部分服务器可能对这个配置的兼容性不同，建议结合服务器的类加载配置一起使用。

3. 构建阶段配置隔离（Maven为例） #

如果用Maven打包EAR，可以通过maven-ear-plugin直接配置目标WAR的类路径隔离：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-ear-plugin</artifactId>
    <version>3.3.0</version>
    <configuration>
        <modules>
            <webModule>
                <groupId>com.yourcompany</groupId>
                <artifactId>your-conflicting-war</artifactId>
                <contextRoot>/your-app</contextRoot>
                <!-- 指定该WAR仅使用自身的类路径 -->
                <classPath>WEB-INF/lib/*</classPath>
            </webModule>
        </modules>
        <libraryDirectory>lib</libraryDirectory>
    </configuration>
</plugin>

这样打包后的EAR会自动为该WAR设置独立的类路径。

重要注意事项 #

• 一定要在目标服务器上测试！不同服务器的类加载机制有差异，确保隔离效果符合预期，避免出现ClassNotFoundException或者版本仍冲突的情况。
• 如果WAR需要依赖EAR中的部分共享库，不要完全排除所有EAR lib，而是只排除冲突的特定JAR，这样能减少不必要的依赖缺失问题。

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