OpenLiberty部署的Web应用无法通过系统类加载器加载第三方类

我来帮你排查这个类加载的问题——你已经配置了Library和类加载器但还是遇到找不到类的错误，而且URLClassLoader能正常加载，说明Jar包本身是可用的，问题大概率出在OpenLiberty的类加载配置或者路径解析上。下面是几个具体的排查和解决方向：

1. 先确认Library路径是否正确 #

首先要排查最基础的路径问题：

• 手动解析${wlp.install.dir}/../custom-java/这个路径，比如你的OpenLiberty安装在/usr/local/openliberty/wlp，那这个路径对应的实际位置是/usr/local/openliberty/custom-java/，确认这个文件夹里确实存在你的第三方Jar包，没有拼写错误（Linux系统下路径大小写敏感）。
• 可以先尝试用绝对路径替换变量路径测试，比如：

  <library id="Lib" apiTypeVisibility="spec, ibm-api, api, stable, third-party">
      <folder dir="/usr/local/openliberty/custom-java/" />
  </library>
  

  排除变量解析失败的可能。

2. 调整类加载器的委托策略与可见性 #

OpenLiberty的类加载器默认是parent-first（优先委托父类加载器，也就是系统/Common类加载器），但可能存在可见性配置的问题：

• 检查classloader标签的parentLast属性，如果你希望系统类加载器优先加载第三方类，保持默认的parentLast="false"即可（默认值就是false，可省略）；如果之前不小心设置了parentLast="true"，会导致应用类加载器优先加载，可能和系统类加载器的加载顺序冲突。
• 简化apiTypeVisibility配置，尝试只保留必要的选项，比如：

  <classloader apiTypeVisibility="api, third-party" commonLibraryRef="Lib"/>
  

  避免过多的可见性规则导致类被过滤。

3. 验证类加载器与Library的关联是否生效 #

• 检查OpenLiberty的messages.log日志，搜索Lib或者第三方类名，查看是否有类加载相关的日志记录，比如是否成功加载了目标文件夹，或者有没有路径不存在的报错。
• 确保application标签里的commonLibraryRef值和library的id完全一致（大小写、拼写都要匹配），你当前的配置是一致的，但可以再确认一遍。

4. 关于“系统类加载器”的正确用法 #

你提到希望改用系统类加载器，这里需要明确：OpenLiberty中的系统类加载器指的是JVM的bootstrap/extension类加载器，它默认只加载JRE核心类和wlp/lib/ext目录下的Jar包。如果要让第三方Jar被系统类加载器加载：

• 直接将Jar包复制到OpenLiberty安装目录下的wlp/lib/ext文件夹中，重启服务器即可，无需配置library和classloader。这种方式的好处是所有应用都能访问这个Jar，但如果只是特定应用需要，推荐还是用Common Library的方式。

总结 #

优先排查路径和日志，确认Library被正确加载；如果一定要用系统类加载器，把Jar放到wlp/lib/ext是最直接的方式；如果只想让当前应用访问，调整Common Library的配置即可解决Class Not Found问题。

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