在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選項集,確保與所有功能相容。