DokumentationExperience Cloud KCS

Vorschau für leere Briefe in AEM 6.5 LTS auf Java 17 oder 21 auflösen

Letzte Aktualisierung: 30. Oktober 2026

In diesem Artikel wird beschrieben, wie Sie ein Problem beheben, bei dem die Briefvorschau in AEM Forms nach der Migration zu AEM 6.5 LTS und der Ausführung auf Java 17 oder 21 leer angezeigt wird. Die Lösung umfasst die Aktualisierung der JVM-Optionen, um den erforderlichen Modulzugriff zu ermöglichen.

Beschreibung description

Umgebung

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

Problem/Symptome

Bei der Vorschau von Briefvorlagen in der Benutzeroberfläche „Korrespondenz erstellen“ wird der Bildschirm leer angezeigt. Dieses Problem hat keine Auswirkungen auf die Vorschau von Forms oder Dokumenten und war in Java 8 oder 11 nicht vorhanden. In Serverprotokollen können Fehler wie 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 angezeigt werden.

Ursache

Ab Java 17 beschränkt die starke Modulverkapselung den für das Correspondence Management-Modul erforderlichen reflektierenden Zugriff, was zu einer leeren Vorschau führt.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem der leeren Briefvorschau zu beheben:

  1. Suchen Sie die Skript- oder Konfigurationsdatei, die JVM-Optionen für Ihren AEM Windows-Dienst festlegt. Bei Windows-Installationen ist dies normalerweise die instsrv.bat-Datei in Ihrem AEM-Installationsverzeichnis.

  2. Öffnen Sie die Datei und finden Sie die Zeile, die JVM-Optionen festlegt (häufig beginnend mit set jvm_options=). Optionen werden normalerweise durch # Zeichen getrennt.

  3. Fügen Sie das folgende JVM-Argument zur Optionsliste hinzu: --add-opens=java.base/java.util=ALL-UNNAMED

    • Beispiel: set jvm_options=-Xmx2048m#--add-opens=java.base/java.util=ALL-UNNAMED#

  4. Speichern Sie die Änderungen in der Datei .

  5. Installieren Sie den AEM Windows-Service neu, um die aktualisierten JVM-Optionen anzuwenden:

    1. Öffnen Sie eine Administrator-Eingabeaufforderung und navigieren Sie zum Verzeichnis mit den Service-Skripten.
    2. Beenden Sie den AEM-Service mit: net stop [ YourAEMServiceName]
    3. Deinstallieren Sie den Dienst: instsrv.bat -uninstall [ YourAEMServiceName]
    4. Installieren Sie den Dienst neu: instsrv.bat [ YourAEMServiceName]
    5. Dienst starten: net start [ YourAEMServiceName]

  6. Melden Sie sich nach dem Neustart des Services bei AEM an und versuchen Sie, einen Brief in der Benutzeroberfläche „Korrespondenz erstellen“ in der Vorschau anzuzeigen. Der Brief sollte jetzt korrekt gerendert werden.

  7. (Empfohlen) Lesen Sie die offizielle Dokumentation von Adobe , um den vollständigen Satz der empfohlenen Java 21---add-opens für AEM 6.5 LTS zu erhalten und die Kompatibilität mit allen Funktionen sicherzustellen.

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