在Java 17或21上的AEM 6.5 LTS中解决空白字母预览问题

本文介绍了如何解决在迁移到AEM 6.5 LTS并在Java 17或21上运行后,AEM Forms中的信件预览显示为空白的问题。 该解决方案包括更新JVM选项以允许必要的模块访问。

描述 description

环境

  • Adobe Experience Manager (AEM) 6.5 LTS
  • Java 17或Java 21

问题/症状

在“创建通信”界面中预览信件模板时,屏幕显示为空白。 此问题不影响Forms或文档预览,在Java 8或11上也不存在。 服务器日志可能显示错误,如java.lang.reflect.InaccessibleObjectException: Unable to make field private transient java.util.NavigableMap java.util.TreeSet.m accessible: module java.base does not "opens java.util" to unnamed module。

原因

从Java 17开始,强模块封装会限制通信管理模块所需的反射访问,从而导致预览空白。

解决方法 resolution

要修复空白字母预览问题,请执行以下步骤:

  1. 找到为AEM Windows服务设置JVM选项的脚本或配置文件。 对于Windows安装,这通常是AEM安装目录中的instsrv.bat文件。

  2. 打开文件并查找设置JVM选项的行(通常以set jvm_options=开头)。 选项通常以#字符分隔。

  3. 将以下JVM参数添加到选项列表: --add-opens=java.base/java.util=ALL-UNNAMED

    • 示例: set jvm_options=-Xmx2048m#--add-opens=java.base/java.util=ALL-UNNAMED#
  4. 将更改保存到文件。

  5. 重新安装AEM Windows服务以应用更新的JVM选项:

    1. 打开Administrator命令提示符并导航到包含服务脚本的目录。
    2. 使用以下方式停止AEM服务: net stop [ YourAEMServiceName]
    3. 卸载服务: instsrv.bat -uninstall [ YourAEMServiceName]
    4. 重新安装服务: instsrv.bat [ YourAEMServiceName]
    5. 启动服务: net start [ YourAEMServiceName]
  6. 服务重新启动后,登录到AEM,并尝试在“创建通信”界面中预览信件。 现在,书信应可正确呈现。

  7. (推荐)查看Adobe的官方文档,了解为AEM 6.5 LTS推荐的整套Java 21 --add-opens选项,以确保与所有功能兼容。

recommendation-more-help
experience-cloud-kcs-help-kbarticles