Domino 12.0.2 FP2服务器java.protocol.handler.pkgs配置差异致XPages报错

配置差异原因 #

• Server2的java.protocol.handler.pkgs配置为com.sun.net.ssl.internal.www.protocol，这是旧版JDK的HTTPS处理器实现，而Domino 12.x官方默认适配的是IBM提供的com.ibm.domino.internal.protocol包，该包专门针对Domino的HTTP JVM环境做了兼容处理。
• 代理与XPages依赖的JVM环境不同：代理运行在Domino后台独立JVM，默认配置不受该参数影响；而XPages运行在HTTP服务对应的JVM，会读取notes.ini中指定的Java协议处理器配置，因此Server2的旧配置仅在XPages场景触发异常。
• Server2的额外错误路径配置大概率是版本迁移遗留、手动误改notes.ini参数，或是安装过程中配置未正确初始化导致的，Server1则使用了Domino 12.0.2 FP2的默认Java配置。

统一配置方案 #

1. 修改notes.ini中的Java参数
   • 在Server2的notes.ini文件中，找到包含java.protocol.handler.pkgs的配置行（通常在JavaUserOptions或独立参数项中），将其值修改为：

     java.protocol.handler.pkgs=com.ibm.domino.internal.protocol
     

   • 同步清理Server2中其他指向错误路径的Java配置（如java.class.path中的无效路径），完全对齐Server1的notes.ini Java相关参数。
2. 重启Domino服务器
   配置修改后必须重启服务器，确保HTTP JVM加载新的协议处理器配置。
3. 验证修复效果
   在XPages的Java类中重新测试java.net.URLConnection访问HTTPS的逻辑，确认java.lang.ClassCastException异常不再出现。

额外注意事项 #

• 无需针对不同服务器编写差异化代码，统一配置后，相同的URLConnection逻辑可在两台服务器上正常运行，减少后续维护成本。
• 后续升级Domino版本时，避免手动修改Java核心协议处理器配置，优先使用官方默认值，防止类似兼容性问题。

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