E: Fehler beim Überprüfen von routes.yaml-Fehler während der Staging- oder Produktionsbereitstellung

Last update: Mon Dec 22 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Dieser Artikel bietet eine Lösung für das Adobe Commerce-Problem mit der Cloud-Infrastruktur, bei dem beim Versuch, das Projekt in der Staging- oder Produktionsumgebung bereitzustellen, die Fehlermeldung E: Fehler beim Überprüfen der routes..yaml angezeigt wird.

Beschreibung description

Betroffene Umgebung

Adobe Commerce auf Cloud-Infrastruktur, alle Versionen

Problem/Symptome

Schritte zur Reproduktion:

Trigger einer Bereitstellung durch Pushen des Codes in die Staging- oder Produktionsumgebung.

Erwartetes :

Die Bereitstellung war erfolgreich.

Tatsächliches :

Die Bereitstellung ist blockiert und die folgende Fehlermeldung wird im Protokoll angezeigt:

Deploying applications Verifying configuration E: Error while verifying routes.yaml.
The following domains are configured for your cluster, but have no routes defined in your routes.yaml file:

- store1.example.com
- store2.example.com
- test-store.example.com

With your current routes.yaml configuration,
    these domains would NOT be served!

In order to continue, please see here for instructions to troubleshoot:
    E: Error verifying routes.yaml error during Staging or Production deploy

Ursache

Dieser Fehler tritt auf, wenn die Routenkonfiguration für alle zusätzlichen Domains, die Ihrem Projekt hinzugefügt wurden, in der routes.yaml-Datei fehlt.

Im Rahmen der Aktualisierung der Adobe Commerce-Self-Service-Aktivierung für die Self-Service-Routenkonfiguration haben wir eine Prüfung vor der Bereitstellung hinzugefügt, um sicherzustellen, dass für alle Domains in Ihrem Projekt Routen in der routes.yaml konfiguriert sind. Wenn bei einer Domain die Routenkonfiguration fehlt, wird die Bereitstellung blockiert.

Lösung resolution

Um die blockierte Bereitstellung zu beheben, aktualisieren Sie die routes.yaml-Datei, um Routen für die in der Fehlermeldung aufgelisteten Domains zu konfigurieren, indem Sie eine der folgenden Methoden verwenden:

Wenden Sie den von Adobe Commerce während des Aktualisierungsprozesses bereitgestellten Patch an.
Fügen Sie die fehlende Routenkonfiguration manuell zur routes.yaml hinzu.

Methode 1: Wenden Sie das von Adobe Commerce bereitgestellte Patch an

Suchen Sie nach einem aktuellen Adobe Commerce-Support-Ticket mit dem Titel "Self-Service-Funktionen für < project_id aktivieren>.
Befolgen Sie die Anweisungen im Ticket, um den Patch anzuwenden, der die Routenkonfiguration für Ihre Cloud-Umgebung aktualisiert.
СÜbergeben und Übertragen der Änderungen, um das Projekt erneut bereitzustellen.

Methode 2: Manuelles Hinzufügen der fehlenden Routenkonfiguration

Um alle Domains in Ihrem Projekt mit derselben Routenkonfiguration zu bedienen, aktualisieren Sie die routes.yaml-Datei, indem Sie Routenvorlagen für die Standarddomäne und alle anderen Domains in Ihrem Projekt hinzufügen, wie im folgenden Beispiel gezeigt:

code language-none
`"http://{default}/": type: upstream upstream: "mymagento:http" "http://{all}/": type: upstream upstream: "mymagento:http"`

СÜbergeben und Übertragen von Änderungen, um das Projekt erneut bereitzustellen.