AEM as a Cloud Service: i18n-ResourceBundle-Cache wird nach Wörterbuchänderungen nicht aktualisiert

Letzte Aktualisierung: 30. August 2026

In Adobe Experience Manager as a Cloud Service werden Aktualisierungen von i18n-Wörterbuchdateien unter /conf möglicherweise nicht im Sling ResourceBundle-Cache angezeigt, sodass Benutzeroberflächenbeschriftungen nicht aufgelöste i18n-Schlüssel anstelle von übersetztem Text anzeigen.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (AEMaaCS)(alle Versionen)

Problem/Symptome

Neu hinzugefügte oder aktualisierte i18n-Schlüssel in /conf/.../i18n/en.json oder fr.json sind im JCR-Repository vorhanden, werden jedoch nicht im Sling ResourceBundle-Cache angezeigt.
Benutzeroberflächenbeschriftungen zeigen in der Autorenumgebung rohe i18n-Schlüssel (z. B. lblExampleKey) anstelle des erwarteten übersetzten Texts an.
Versuche, Client-Bibliotheken neu zu erstellen oder den Cache zu invalidieren, lösen das Problem nicht.

Ursache

Veraltete oder in Konflikt stehende i18n-Wörterbuchdateien unter /conf können verhindern, dass der Sling ResourceBundle-Cache mit neuen Schlüsseln aktualisiert wird. Dies führt zu nicht aufgelösten Benutzeroberflächen-Kennzeichnungen. Wenn Sie die veralteten Knoten löschen und sicherstellen, dass nur die beabsichtigten Wörterbücher vorhanden sind, kann der Cache aktualisiert und die richtigen Übersetzungen angezeigt werden.

Lösung resolution

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

Identifizieren Sie unter /conf veraltete oder widersprüchliche i18n-Wörterbuchdateien wie /conf/<project>/i18n/en.json und fr.json.
Erstellen Sie ein FileVault-Inhaltspaket mit einer Filterdefinition, die auf die veralteten Wörterbuchdateien zum Löschen abzielt. Verwenden Sie mode="replace" für jeden veralteten Wörterbuchknoten, den Sie entfernen möchten, und lassen Sie die Paket-Payload für diese Pfade leer, damit die Installation die angegebenen Knoten aus dem Repository entfernt.
Stellen Sie das Paket über Ihre CI/CD-Pipeline in der Autorenumgebung bereit.
Replizieren Sie die Änderungen in der Veröffentlichungsumgebung, um Konsistenz über alle Ebenen hinweg sicherzustellen.
Stellen Sie sicher, dass die veralteten Wörterbuchdateien (z. B. /conf/<project>/i18n/en.json und fr.json) nicht mehr zugänglich sind und geben Sie eine 404-Antwort zurück, wenn Sie direkt darauf zugreifen.
Bestätigen Sie, dass die Benutzeroberflächen-Beschriftungen jetzt in den richtigen übersetzten Text aufgelöst werden.

Hinweis

Wenn Sie Wörterbücher zu /apps migrieren, fügen Sie die neuen Wörterbücher dort hinzu und stellen Sie sicher, dass die alten /conf den Ersetzungsmodus verwenden, um veraltete Knoten in derselben Version zu entfernen.