安装war包到themes时WebSphere Portal启动报SRVE0293E错误求助

关联报错信息 #

无法显示portlet，发生异常。用户操作：请检查服务器日志，其中存在与此错误关联的格式为“while rendering a page...”的警告消息，该消息包含更多错误详情，最可能的诱因为控制台模块已被卸载。

核心异常日志：
SRVE0293E: [Servlet Error]-[portal]: java.lang.NoClassDefFoundError: com.ibm.wps.cei.DebugController

解决步骤 #

第一步：紧急回滚恢复服务 #

• 停止WebSphere Portal相关服务，集群环境先停止所有节点服务再停止dmgr服务，单机环境直接停止Portal服务即可
• 进入Portal主题部署路径，默认路径为[WPS安装根目录]/wp_profile/installedApps/[cell名]/wps.ear/wps.war/themes，删除最近上传的自定义war包对应的所有文件
• 清理服务临时缓存：删除[WPS安装根目录]/wp_profile/temp、[WPS安装根目录]/wp_profile/wstemp两个目录下的全部内容
• 重启Portal服务，验证基础控制台是否可以正常访问

第二步：调整自定义war包配置 #

• 该报错根因为自定义war包的类加载配置错误，或是war包内携带了和Portal原生环境冲突的依赖包，覆盖了系统默认的公共类路径
• 检查war包内WEB-INF/ibm-web-ext.xml配置，将类加载器顺序设置为父类优先（Parent First），禁止设置为子类优先
• 清理war包内的冗余依赖，所有com.ibm.wps开头的相关依赖均为Portal原生提供，无需打包到自定义war包内
• 调整完成后，通过WAS控制台的企业应用部署流程上传war包，完成应用映射、节点同步操作，不要直接手动将war包放入themes目录

第三步：部署后验证 #

• 服务启动完成后查看[WPS安装根目录]/wp_profile/logs/WebSphere_Portal/SystemOut.log日志，确认无NoClassDefFoundError类报错
• 分别访问WAS控制台和Portal前台页面，确认所有portlet可以正常加载，无异常提示

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