在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