在WAS 8.5.5.16部署MyFaces 2.3应用时遇初始化错误求助

这个错误的核心是类加载冲突：WebSphere Application Server (WAS) 8.5.5.x默认集成了旧版本的MyFaces（对应JSF 2.2规范），而你部署的应用用了MyFaces 2.3版本。容器自带的com.ibm.ws.jsf.config.annotation.WASMyFacesAnnotationProvider是基于旧版MyFaces的AnnotationProvider接口实现的，和你应用里2.3版本的接口定义不兼容，直接导致类型转换失败。

下面是具体的修复方案：

1. 强制应用使用自身打包的MyFaces 2.3实现 #

步骤1：修改web.xml添加配置参数 #

在应用的web.xml里加入以下上下文参数，告诉WAS不要用自带的JSF初始化器，转而使用MyFaces提供的初始化器：

<context-param>
    <param-name>org.apache.myfaces.USE_MYFACES_INITIALIZER</param-name>
    <param-value>true</param-value>
</context-param>
<context-param>
    <param-name>com.ibm.ws.jsf.JSF_IMPL_CLASS</param-name>
    <param-value>org.apache.myfaces.webapp.StartupServletContextListener</param-value>
</context-param>

步骤2：配置WAS类加载策略为PARENT_LAST #

WAS默认是PARENT_FIRST（优先加载容器自带的类），这会让旧版MyFaces的API先被加载，和应用的2.3版本冲突。需要调整应用的类加载设置：

• 登录WAS管理控制台，找到你的部署应用
• 进入应用程序 > 你的应用 > 类加载和更新检测
• 将类加载顺序设置为「类加载器加载本地类，然后委托给父类加载器（PARENT_LAST）」
• 保存配置后重启应用

2. 确保应用依赖的完整性与纯净性 #

• 确认你的应用WAR包中已经包含完整的MyFaces 2.3依赖：myfaces-api-2.3.x.jar和myfaces-impl-2.3.x.jar
• 检查你的构建依赖（比如Maven/Gradle），排除任何可能引入的容器自带JSF API依赖，避免重复冲突

3. 版本兼容性说明 #

WAS 8.5.5.x官方原生支持的是JSF 2.2规范，MyFaces 2.3属于JSF 2.3规范实现，所以必须通过上述方式强制隔离容器的JSF实现，才能正常运行。

错误日志参考：

0000005c AbstractFaces E MyFaces初始化时发生错误：Class com.ibm.ws.jsf.config.annotation.WASMyFacesAnnotationProvider is no org.apache.myfaces.spi.AnnotationProvider
java.lang.IllegalArgumentException: Class com.ibm.ws.jsf.config.annotation.WASMyFacesAnnotationProvider is no org.apache.myfaces.spi.AnnotationProvider
	at org.apache.myfaces.shared.util.ClassUtils.buildApplicationObject(ClassUtils.java:567)
	at org.apache.myfaces.shared.util.ClassUtils.buildApplicationObject(ClassUtils.java:534)
	at org.apache.myfaces.spi.impl.DefaultAnnotationProviderFactory.resolveAnnotationProviderFromService(DefaultAnnotationProviderFactory.java:138)
	at org.apache.myfaces.spi.impl.DefaultAnnotationProviderFactory.createAnnotationProvider(DefaultAnnotationProviderFactory.java:93)
	at org.apache.myfaces.spi.impl.DefaultAnnotationProviderFactory.getAnnotationProvider(DefaultAnnotationProviderFactory.java:62)
	at org.apache.myfaces.config.annotation.AnnotationConfigurator.createFacesConfig(AnnotationConfigurator.java:90)
	at org.apache.myfaces.config.DefaultFacesConfigurationProvider.getAnnotationsFacesConfig(DefaultFacesConfigurationProvider.java:201)
	at org.apache.myfaces.config.DefaultFacesConfigurationMerger.getFacesConfigData(DefaultFacesConfigurationMerger.java:92)
	at org.apache.myfaces.config.FacesConfigurator.configure(FacesConfigurator.java:603)
	at org.apache.myfaces.webapp.AbstractFacesInitializer.buildConfiguration(AbstractFacesInitializer.java:456)
	at org.apache.myfaces.webapp.Jsp21FacesInitializer.initContainerIntegration(Jsp21FacesInitializer.java:70)
	at org.apache.myfaces.webapp.AbstractFacesInitializer.initFaces(AbstractFacesInitializer.java:190)
	at org.apache.myfaces.webapp.StartupServletContextListener.contextInitialized(StartupServletContextListener.java:103)
	at com.ibm.ws.webcontainer.webapp.WebApp.notifyServletContextCreated(WebApp.java:1736)
	at com.ibm.ws.webcontainer.webapp.WebAppImpl.initialize(WebAppImpl.java:415)
	at com.ibm.ws.webcontainer.webapp.WebGroupImpl.addWebApplication(WebGroupImpl.java:88)
	at com.ibm.ws.webcontainer.VirtualHostImpl.addWebApplication(VirtualHostImpl.java:171)
	at com.ibm.ws.webcontainer.WSWebContainer.addWebApp(WSWebContainer.java:904)
	at com.ibm.ws.webcontainer.WSWebContainer.addWebApplication(WSWebContainer.java:789)
	at com.ibm.ws.webcontainer.component.WebContainerImpl.install(WebContainerImpl.java:427)
	at com.ibm.ws.webcontainer.component.WebContainerImpl.start(WebContainerImpl.java:719)
	at com.ibm.ws.runtime.component.ApplicationMgrImpl.start(ApplicationMgrImpl.java:1211)
	at com.ibm.ws.runtime.component.DeployedApplicationImpl.fireDeployedObjectStart(DeployedApplicationImpl.java:1462)
	at com.ibm.ws.runtime.component.DeployedModuleImpl.start(DeployedModuleImpl.java:641)
	at com.ibm.ws.runtime.component.DeployedApplicationImpl.start(DeployedApplicationImpl.java:1040)
	at com.ibm.ws.runtime.component.ApplicationMgrImpl.startApplication(ApplicationMgrImpl.java:795)
	at com.ibm.ws.runtime.component.ApplicationMgrImpl$5.run(ApplicationMgrImpl.java:2279)
	at com.ibm.ws.security.auth.ContextManagerImpl.runAs(ContextManagerImpl.java:5482)
	at com.ibm.ws.security.auth.ContextManagerImpl.runAsSystem(ContextManagerImpl.java:5698)
	at com.ibm.ws.security.core.SecurityContext.runAsSystem(SecurityContext.java:255)
	at com.ibm.ws.runtime.component.ApplicationMgrImpl.start(ApplicationMgrImpl.java:2284)
	at com.ibm.ws.runtime.component.CompositionUnitMgrImpl.start(CompositionUnitMgrImpl.java:436)
	at com.ibm.ws.runtime.component.CompositionUnitImpl.start(CompositionUnitImpl.java:123)
	at com.ibm.ws.runtime.component.CompositionUnitMgrImpl.start(CompositionUnitMgrImpl.java:379)
	at com.ibm.ws.runtime.component.CompositionUnitMgrImpl.access$500(CompositionUnitMgrImpl.java:127)
	at com.ibm.ws.runtime.component.CompositionUnitMgrImpl$CUInitializer.run(CompositionUnitMgrImpl.java:985)
	at com.ibm.wsspi.runtime.component.WsComponentImpl$_AsynchInitializer.run(WsComponentImpl.java:524)
	at com.ibm.ws.util.ThreadPool$Worker.run(ThreadPool.java:1892)

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