求助：HCL Designer与浏览器出现com.ibm.xsp相关依赖错误

错误信息 #

com.ibm.xsp.page.FacesPageException: Could not load page /Home.xsp because the corresponding class xsp.Home was not com.ibm.xsp.page.compiled.CompiledPageDispatcher.
com.ibm.xsp.page.compiled.CompiledPageDriver.loadPage(CompiledPageDriver.java:77)
com.ibm.xsp.application.ViewHandlerExImpl._createViewRoot(ViewHandlerExImpl.java:528)
com.ibm.xsp.application.ViewHandlerExImpl.createViewRoot(ViewHandlerExImpl.java:596)
com.ibm.xsp.application.ViewHandlerExImpl.doCreateView(ViewHandlerExImpl.java:144)
com.ibm.xsp.application.ViewHandlerEx.createView(ViewHandlerEx.java:90)
com.ibm.xsp.webapp.FacesServlet.serviceView(FacesServlet.java:254)
com.ibm.xsp.webapp.FacesServletEx.serviceView(FacesServletEx.java:157)
com.ibm.xsp.webapp.FacesServlet.service(FacesServlet.java:163)
com.ibm.xsp.webapp.FacesServletEx.service(FacesServletEx.java:138)
com.ibm.xsp.webapp.DesignerFacesServlet.service(DesignerFacesServlet.java:103)
com.ibm.designer.runtime.domino.adapter.ComponentModule.invokeServlet(ComponentModule.java:600)
com.ibm.domino.xsp.module.nsf.NSFComponentModule.invokeServlet(NSFComponentModule.java:1352)
com.ibm.designer.runtime.domino.adapter.ComponentModule$AdapterInvoker.invokeServlet(ComponentModule.java:877)
com.ibm.designer.runtime.domino.adapter.ComponentModule$ServletInvoker.doService(ComponentModule.java:820)
com.ibm.designer.runtime.domino.adapter.ComponentModule.doService(ComponentModule.java:589)
com.ibm.domino.xsp.module.nsf.NSFComponentModule.doService(NSFComponentModule.java:1336)
com.ibm.domino.xsp.module.nsf.NSFService.doServiceInternal(NSFService.java:662)
com.ibm.domino.xsp.module.nsf.NSFService.doService(NSFService.java:482)
com.ibm.designer.runtime.domino.adapter.LCDEnvironment.doService(LCDEnvironment.java:357)
com.ibm.designer.runtime.domino.adapter.LCDEnvironment.service(LCDEnvironment.java:313)
com.ibm.domino.xsp.bridge.http.engine.XspCmdManager.service(XspCmdManager.java:272)

解决方案 #

这个错误源于XPages页面编译类的依赖缺失，核心是缺少页面编译调度相关的Jar包，按以下步骤处理：

• 补充核心依赖Jar包
  必须添加两个关键Jar包：

  1. com.ibm.xsp.core.jar：包含XPages基础运行类，是XSP页面加载的核心依赖
  2. com.ibm.xsp.page.compiled.jar：包含错误中提到的CompiledPageDispatcher类，负责编译后XSP页面的调度加载

• 获取Jar包的正确路径
  从HCL Designer或Domino服务器安装目录提取：

  • HCL Designer：{Designer安装目录}\framework\runtime\rcp\plugins，找到文件名带com.ibm.xsp.core和com.ibm.xsp.page.compiled的Jar文件（文件名含版本号）
  • Domino服务器：{Domino安装目录}\osgi\shared\eclipse\plugins，同样提取对应Jar包

• 清理与部署

  1. 移除项目中版本不匹配或重复的XSP相关Jar包，避免依赖冲突
  2. 将提取的Jar包添加到NSF项目的构建路径（Build Path）
  3. 在HCL Designer中执行Project -> Clean，清理项目编译缓存后重新编译
  4. 重启HCL Designer及Domino测试服务器

• 额外检查

  • 确认NSF项目的XSP编译设置：打开NSF属性，进入XPages -> Compile Options，确保编译模式设为Compile on Save或Compile All
  • 所有XSP相关Jar包版本需与HCL Designer/Domino服务器版本一致，禁止混合不同版本Jar包

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