DokumentationExperience Cloud KCS

Veröffentlichen von Seiten mit tief verschachtelten Inhaltsfragmenten

Letzte Aktualisierung: 1. August 2026

In diesem Artikel wird beschrieben, wie Sie Situationen bewältigen können, in denen AEM Sites-Seiten, die auf tief verschachtelte Inhaltsfragmente verweisen, aufgrund von Zeitüberschreitungen während des rekursiven Referenzsuchvorgangs nicht veröffentlicht werden können.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (alle Versionen)

Problem/Symptome

Beim Veröffentlichen von AEM Sites-Seiten, die auf Inhaltsfragmente mit tief oder breit verschachtelten Verweisen verweisen, wird die Seite nicht in der Payload „Veröffentlichung verwalten“ angezeigt und nicht veröffentlicht. Dies tritt auf, wenn ein Inhaltsfragment auf viele andere Inhaltsfragmente verweist, was zu Tausenden verschachtelter Verweise und mehreren Verschachtelungsebenen führt. Der Referenzüberprüfungsprozess wird langsam und kann eine Zeitüberschreitung verursachen, sodass die Seite nicht in den Veröffentlichungs-Workflow aufgenommen wird. In der Benutzeroberfläche wird keine explizite Fehlermeldung angezeigt, aber die erwartete Seite fehlt in der Veröffentlichungs-Payload.

Ursache

Die rekursive Referenzsuche nach tief verschachtelten Inhaltsfragmenten kann zu Leistungseinbußen und Timeouts führen, wodurch Seiten nicht in die Veröffentlichungs-Payload aufgenommen werden. Das Deaktivieren der rekursiven Suche verbessert die Leistung, erfordert jedoch die manuelle Verwaltung der Veröffentlichung verschachtelter Fragmente.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben, dass AEM Sites-Seiten, die auf tief verschachtelte Inhaltsfragmente verweisen, nicht veröffentlicht werden können:

  1. Deaktivieren Sie die rekursive Suche nach Inhaltsfragmentreferenzen, indem Sie die Konfiguration für com.day.cq.wcm.core.impl.reference.ActivationReferenceSearchServiceImpl aktualisieren und die Option zum Deaktivieren der rekursiven Suche nach Inhaltsfragmentreferenzen festlegen.

  2. Aktualisieren Sie die Konfiguration über Cloud Manager:

    • Fügen Sie in Ihrem Cloud Manager-Projekt die OSGi-Konfigurationsdatei für com.day.cq.wcm.core.impl.reference.ActivationReferenceSearchServiceImpl hinzu oder aktualisieren Sie sie.
    • Legen Sie "enable.recursive.cf.reference.search": false in der -Konfiguration fest.
    • Übertragen Sie die Konfiguration und stellen Sie sie über Ihre Cloud Manager-Pipeline bereit.

  3. Alternativ können Sie die Konfiguration in lokalen oder produktionsfremden Umgebungen über die OSGi-Konsole aktualisieren:

    • Melden Sie sich bei der AEM-Autoreninstanz an.
    • Navigieren Sie zu /system/console/configMgr.
    • Suchen Sie nach ActivationReferenceSearchServiceImpl.
    • Bearbeiten Sie die Konfiguration und legen Sie die rekursive Inhaltsfragmentverweissuche auf false fest.
    • Speichern Sie die Konfiguration.

  4. Nachdem Sie die rekursive Suche deaktiviert haben, versuchen Sie, die betroffene Seite erneut mit „Veröffentlichung verwalten“ zu veröffentlichen. Die Seite sollte jetzt in die Veröffentlichungs-Payload aufgenommen und erfolgreich veröffentlicht werden.

  5. Veröffentlichen Sie bei Bedarf manuell tief verschachtelte Inhaltsfragmente. Wenn die rekursive Suche deaktiviert ist, werden nur Verweise der ersten Ebene automatisch aufgelöst. Stellen Sie sicher, dass alle erforderlichen verschachtelten Inhaltsfragmente veröffentlicht werden, indem Sie sie manuell über die CF/Assets-Konsolen veröffentlichen oder indem Sie die entsprechenden CF-Ordner in Ihren Veröffentlichungsprozess einbeziehen.

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