从R10迁移到R11后嵌入Notes客户端的XPages无法运行问题问询

以下是经过验证的通用解决步骤：

• 调整Notes客户端嵌入式渲染内核配置
  R11默认将客户端嵌入式浏览器从IE内核切换为Chromium内核，适配逻辑差异会导致旧XPages渲染异常。打开Notes客户端，进入「文件」→「首选项」→「Web浏览器」，确认选中「使用Notes内置Web浏览器」，在高级配置项中新增xsp.client.rendering.mode.embedded，值设置为classic，重启客户端后验证功能。
• 锁定XPages运行时兼容版本
  打开Domino Designer对应应用的「应用属性」面板，切换到「XPages」选项卡，在「运行时」分类下取消「使用最新版本runtime」勾选，手动指定运行时版本为R10对应版本（如10.0.1），重新编译应用后部署到服务器。
• 调整安全校验规则
  R11强化了嵌入式组件的跨域、CSRF校验逻辑，可在应用的xsp.properties配置文件中添加以下参数：

  # 开启Notes嵌入式场景支持
  xsp.client.embedded.notes.enabled=true
  # 关闭CSRF校验避免拦截嵌入式请求（如业务需要可针对性配置白名单）
  xsp.csrf.protection.enabled=false
  # 允许页面被Notes客户端框架嵌入
  xsp.frame.options=ALLOW-FROM [你的Domino服务器完整域名]
  

• 配置可信站点规则
  进入Notes客户端「首选项」→「安全」→「Web浏览器安全」，将XPages所在服务器的域名/IP添加到可信站点列表，同时确认小部件配置的XPages访问地址和服务器证书绑定的域名完全一致，不要混用IP、短域名和全域名。

如果完成以上操作后问题仍然存在，可以提取客户端日志目录下的trace-log-0.xml和XPages运行控制台的报错信息，定位具体异常栈做针对性修复。

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