OpenShift上IBM Liberty部署MyFaces JSF应用遇NoClassDefFoundError的解决方法

核心原因 #

IBM Liberty默认的jsf-2.3特性集成的是Mojarra（官方JSF实现），而你的应用打包了Apache MyFaces，两者在类加载层面发生冲突，导致容器无法正确加载JSF相关类，进而出现NoClassDefFoundError和容器初始化失败的问题。另外，Java 8环境下使用JSF 2.3需确保版本兼容，MyFaces的EE6初始化器可能和Liberty的Java EE 8环境不匹配。

具体解决方案 #

方案1：移除Liberty自带JSF特性，使用应用自带的MyFaces #

• 修改server.xml，从<featureManager>里删掉jsf-2.3特性
• 确认EAR包完整包含MyFaces核心库（myfaces-api.jar、myfaces-impl.jar）及所有依赖库，版本需适配Java 8和Servlet 4.0（推荐用MyFaces 2.3.x系列）
• 检查应用的web.xml或faces-config.xml，移除可能和容器特性冲突的配置，让MyFaces自行完成初始化

方案2：替换Liberty的JSF实现为MyFaces #

如果想保留Liberty的容器管理特性，可以替换默认JSF实现：

1. 下载与Liberty 25.0.0.11兼容的MyFaces特性包
2. 将特性包安装到Liberty的usr/extension目录
3. 修改server.xml，把<featureManager>中的jsf-2.3替换为MyFaces对应的特性（比如myfaces-2.3，具体名称参考特性包文档）
4. 删除应用中打包的MyFaces库，避免重复加载

方案3：调整类加载策略（临时应急） #

如果暂时无法修改特性或移除应用内的MyFaces，可以尝试调整类加载顺序，让应用类优先加载：
在EAR的META-INF/ibm-application-bnd.xml或Web模块的WEB-INF/ibm-web-bnd.xml中添加配置：

<application-bnd xmlns="http://websphere.ibm.com/xml/ns/javaee">
  <classloader delegation="parentLast"/>
</application-bnd>

注意：parentLast策略可能引发其他容器类与应用类的冲突，仅用于临时测试，不建议长期使用

额外检查点 #

• 确认MyFaces版本支持Java 8和Servlet 4.0：MyFaces 2.3.x完全兼容，避免使用2.2.x及以下老版本
• 检查EAR包结构：MyFaces的jar包若属于WAR模块，放在WEB-INF/lib；若为EAR共享库，放在EAR/lib目录
• 查看Liberty错误日志，确认是否有其他依赖缺失（比如MyFaces依赖的Commons BeanUtils、Commons Logging等库是否存在）

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