DokumentationExperience Cloud KCS

AEM Cloud Manager-DEV-Bereitstellungen schlagen aufgrund von XML- und ClientLib-Fehlern fehl

Letzte Aktualisierung: 27. August 2026

In diesem Artikel werden die Ursachen und Lösungsschritte für Bereitstellungsfehler und verlängerte Bereitstellungszeiten in Adobe Experience Manager (AEM) Cloud Manager-Entwicklungsumgebungen erläutert, die durch XML-Syntaxfehler und Probleme bei der Kompilierung der Client-Bibliothek verursacht wurden.

Beschreibung description

Umgebung

  • Adobe Experience Manager (AEM) Cloud Manager (alle Versionen)

Problem/Symptome

  • Entwicklungsbereitstellungen dauern erheblich länger als üblich (mehr als zwei Stunden) und schlagen schließlich während der Bereitstellungsphase fehl.

  • Die Bereitstellungs-Pipeline durchläuft die Phasen Validierung, Build, Unit-Tests, Codescan und Image-Erstellung , schlägt jedoch in der Phase der Bereitstellung für Entwicklung fehl.

  • Bereitstellungsprotokolle zeigen Fehler im Zusammenhang mit fehlenden XML-End-Tags in Inhaltspaketen an, z. B.:

    Der Elementtyp „content“ muss durch das entsprechende End-Tag "< /content“ > werden

    Der Elementtyp „header“ muss durch den entsprechenden End-Tag "< /header“ > werden

  • Verteilungspaket-Importe schlagen aufgrund von XML-Analysefehlern fehl.

  • Client-Bibliothek (ClientLib) Es treten WENIGER Kompilierungsfehler auf, z. B. undefinierte Variablen (z. B. @white) und fehlende Mixins.

  • Bei nicht aufgelösten benutzerdefinierten Modellklassen treten Java-Kompilierungsfehler auf.

  • Diese Fehler waren zuvor vorhanden, verursachten jedoch keine Bereitstellungsfehler. Sie führen jetzt zu Pipeline-Fehlern.

Ursache

Bereitstellungsfehler treten aufgrund von XML-Syntaxfehlern (fehlende End-Tags), nicht aufgelösten Client-Bibliotheksvariablen oder Mixins und fehlenden benutzerdefinierten Java-Modellklassen auf. Jüngste Pipeline- oder Umgebungsänderungen können dazu führen, dass diese Probleme bei -Bereitstellungen fehlschlagen, auch wenn sie zuvor nicht blockiert waren.

Lösung resolution

Führen Sie zur Behebung des Problems folgende Schritte aus:

  1. Greifen Sie auf die Cloud Manager-Pipeline-Ausführungsprotokolle für die fehlgeschlagene Bereitstellung zu.
  2. Identifizieren Sie alle XML-Parsing-Fehler und Kompilierungsfehler der Client-Bibliothek.
  3. Suchen Sie die referenzierten XML-Dateien, z. B. unter /conf/.../settings/wcm/templates/.
  4. Stellen Sie sicher, dass alle XML-Elemente, z. B. <content> und <header>, übereinstimmende schließende Tags wie </content> und </header> enthalten.
  5. Validieren Sie die XML-Struktur mit einem XML-Validator, bevor Sie Änderungen übergeben.
  6. Überprüfen Sie LESS- und CSS-Dateien auf undefinierte Variablen wie @white und @mid-blue sowie fehlende Mixins wie .label-small-style() und .media().
  7. Fehlende Variablen und Mixins definieren oder Importe aktualisieren, um die erforderlichen Definitionen einzuschließen.
  8. Erstellen Sie die Client-Bibliotheken lokal neu, um eine erfolgreiche Kompilierung zu bestätigen.
  9. Stellen Sie sicher, dass alle benutzerdefinierten Sling-Modellklassen, auf die von Komponenten verwiesen wird, vorhanden sind und korrekt in die Codebasis importiert wurden.
  10. Beheben Sie alle fehlenden Abhängigkeiten oder falschen Paketverweise.
  11. Übertragen Sie die Änderungen an das Repository, nachdem Sie die erforderlichen Korrekturen vorgenommen haben.
  12. Führen Sie einen Trigger zu einer neuen Bereitstellung in Cloud Manager aus und überwachen Sie die Pipeline, um zu bestätigen, dass sie erfolgreich abgeschlossen wird.
recommendation-more-help
experience-cloud-kcs-help-kbarticles