在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
要修复空白字母预览问题,请执行以下步骤:
-
找到为AEM Windows服务设置JVM选项的脚本或配置文件。 对于Windows安装,这通常是AEM安装目录中的
instsrv.bat文件。 -
打开文件并查找设置JVM选项的行(通常以
set jvm_options=开头)。 选项通常以#字符分隔。 -
将以下JVM参数添加到选项列表:
--add-opens=java.base/java.util=ALL-UNNAMED- 示例:
set jvm_options=-Xmx2048m#--add-opens=java.base/java.util=ALL-UNNAMED#
- 示例:
-
将更改保存到文件。
-
重新安装AEM Windows服务以应用更新的JVM选项:
- 打开Administrator命令提示符并导航到包含服务脚本的目录。
- 使用以下方式停止AEM服务:
net stop [ YourAEMServiceName] - 卸载服务:
instsrv.bat -uninstall [ YourAEMServiceName] - 重新安装服务:
instsrv.bat [ YourAEMServiceName] - 启动服务:
net start [ YourAEMServiceName]
-
服务重新启动后,登录到AEM,并尝试在“创建通信”界面中预览信件。 现在,书信应可正确呈现。
-
(推荐)查看Adobe的官方文档,了解为AEM 6.5 LTS推荐的整套Java 21
--add-opens选项,以确保与所有功能兼容。