升级HCL Domino Client至V12后Xpages更新站点安装失败（CWPPR0031W）

问题分析 #

升级到Domino Client V12后，Xpages构建时提示缺少com.paulwithers.openLog库，通过更新站点URL安装时出现「未找到可接受的功能」或CWPPR0031W（302跳转）错误，尽管服务器端该Bundle已处于ACTIVE状态。以下是针对性修复方案：

方案1：直接从服务器提取Bundle本地安装 #

• 登录Domino服务器，找到数据目录下的osgi/shared/eclipse/plugins文件夹，定位到com.paulwithers.openLog_6.0.1.201607151221.jar文件
• 在Domino Client中，打开「文件→应用程序→安装」，选择「从本地文件或目录」，选中该jar文件完成安装
• 安装完成后重启客户端，验证Xpages构建是否恢复正常

方案2：解决更新站点302跳转问题 #

• 在浏览器中访问更新站点URL，检查是否存在自动跳转（302），直接使用跳转后的最终URL进行安装
• 若更新站点托管在Domino服务器上，检查HTTP/HTTPS配置：确保没有错误的强制跳转规则，且站点的site.xml文件能正常访问
• 复制浏览器中可正常加载的更新站点URL，粘贴到客户端安装向导中重试

方案3：清理客户端OSGI缓存 #

• 完全关闭Domino Client
• 定位到客户端OSGI缓存目录：
  • Windows路径示例：C:\Users\[你的用户名]\AppData\Local\HCL\Notes\Data\workspace\.config\org.eclipse.osgi
  • 同时清理workspace\plugins目录下的缓存文件（建议先备份）
• 重启客户端后，重新尝试通过更新站点安装依赖库

方案4：适配V12的Bundle版本升级 #

• Domino V12的OSGI框架版本较V10提升，旧版本的openLog（6.0.1）可能存在兼容性问题
• 获取适配Domino V12的openLog新版本，替换服务器上的旧Bundle：
  1. 执行tell http quit停止HTTP服务
  2. 替换osgi/shared/eclipse/plugins下的旧jar文件
  3. 启动HTTP服务，执行tell http osgi refresh com.paulwithers.openLog确保Bundle重新加载
• 替换完成后，再通过更新站点或本地安装方式同步到客户端

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