WebSphere LibertyCore类加载器加载错误类 两应用冲突解决方法

问题背景 #

在Liberty Server上部署A、B两个应用，两个应用均内置esapi-2.0.1依赖库。原有server.xml配置如下：

<library apiTypeVisibility="spec,ibm,api,ibm-spi,third-paty" id="extA">
<fileset dir ="apps/web/A/extA" includes=*.jar"/>
</library>

<enterpriseApplication location="A.ear" name="A">
<classloader privateLibraryRef="extA" apiTypeVisibility="spec,ibm,api,ibm-spi,third-paty/>
</enterpriseApplication>

故障现象：服务器启动时，应用B会错误加载A应用依赖内org.opensaml包下的SecurityConfiguration类；删除server.xml中A应用的<enterpriseApplication>配置块后，应用B可正常运行。

故障根因 #

• 配置存在语法错误：third-paty为拼写错误（正确值为third-party），同时存在includes属性缺前引号、classloader标签属性未闭合的问题，导致Liberty未按预期为A应用构建隔离的私有类加载器，extA目录下的jar包被暴露到公共类检索路径，可被其他应用的类加载器扫描到。
• 未配置类加载委托规则：默认parentFirst委托模式会优先从上层公共路径加载类，两个应用内置的esapi、opensaml类包路径完全一致，最终出现B应用跨应用加载A路径下类的问题。

正确配置步骤 #

1. 修正所有语法错误，补全缺失的引号、闭合标签，修正拼写错误的配置值。
2. 为应用类加载器添加delegation="parentLast"属性，让应用优先加载自身内置/私有依赖的类，避免从公共路径错拿其他应用的类。
3. 为B应用也显式配置独立类加载规则，即使B的依赖全部打包在ear包内，也显式声明隔离策略，避免后续新增全局依赖时出现串类问题。

修正后的配置参考：

<!-- 定义A应用专属私有依赖库，修正拼写错误 -->
<library apiTypeVisibility="spec,ibm,api,ibm-spi,third-party" id="extA">
    <fileset dir="apps/web/A/extA" includes="*.jar"/>
</library>

<!-- A应用类加载配置，开启parentLast委托模式，严格隔离私有依赖 -->
<enterpriseApplication location="A.ear" name="A">
    <classloader 
        privateLibraryRef="extA" 
        apiTypeVisibility="spec,ibm,api,ibm-spi,third-party" 
        delegation="parentLast"/>
</enterpriseApplication>

<!-- B应用类加载配置，同样开启独立隔离、parentLast委托 -->
<enterpriseApplication location="B.ear" name="B">
    <classloader 
        apiTypeVisibility="spec,ibm,api,ibm-spi,third-party" 
        delegation="parentLast"/>
</enterpriseApplication>

额外注意事项 #

• 禁止将esapi、opensaml这类持有静态配置、静态类实例的依赖放到Liberty全局共享库目录（如默认的lib/global目录），否则会出现跨应用配置串用、类实例冲突的问题。
• 两个应用的esapi配置文件（ESAPI.properties、validation.properties等）必须放在各自应用的类路径根目录，不要放到外置公共路径，避免配置读取冲突。
• 配置修改完成后，先清理Liberty的work、temp缓存目录再重启服务，避免旧的类缓存导致问题复现。

内容的提问来源于stack exchange，提问作者Let'sLearn