Dokumentation

Fehlerbehebung bei Fehlern des Kompatibilitäts-Tools für Upgrades

Letzte Aktualisierung: 17. Juni 2025

In diesem Artikel werden die Fehler erläutert, auf die Sie bei der Verwendung des Upgrade-Kompatibilitäts-Tools stoßen können, und Lösungen angeboten, um eine erfolgreiche Ausführung sicherzustellen.

Beschreibung

Umgebung

Adobe Commerce-Versionen ab 2.3.0

​1. Segmentierungsfehler

Ursache: Wenn zwei Module denselben Namen haben, zeigt das Upgrade-Kompatibilitäts-Tool einen Segmentierungsfehler an.

2. Leere Ausgabe

Schritte zur Reproduktion:

  1. Wenn nach Ausführung dieses Bash-Befehls:

    bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION
    
  2. Die einzige Ausgabe ist Upgrade compatibility tool:

    bin/uct upgrade:check /var/www/project/magento/ -c 2.4.1
    Upgrade compatibility tool
    

Ursache:

Die wahrscheinliche Ursache ist eine PHP-Speicherbegrenzung.

Es gibt zwei mögliche Lösungen, um diese PHP Speicherbegrenzung zu vermeiden.

Auflösung

Lösung für Segmentierungsfehler:

Um diesen Fehler zu vermeiden, wird empfohlen, den Pfad zum -Modul als Argument anzugeben:

```bashbin/uct upgrade:check --current-version=2.4.4 path/to/the/module```

Warnung: Das Upgrade-Kompatibilitäts-Tool kann die Code-Basis möglicherweise nicht analysieren, wenn sie eine zirkuläre Abhängigkeit zwischen Methoden enthält.

Lösungen für leere Ausgaben:

Lösung 1:

Überschreiben Sie die Speicherbegrenzung, indem Sie memory_limit auf -1 setzen:

php -d memory_limit=-1 /bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION

Hinweis: Die M2_VERSION ist die Adobe Commerce-Zielversion, die Sie mit Ihrer Adobe Commerce-Instanz vergleichen möchten.

Lösung 2:

Durch Hinzufügen der -m Option kann das Upgrade-Kompatibilitäts-Tool jedes einzelne Modul unabhängig analysieren, um zu vermeiden, dass zwei Module mit demselben Namen in Ihrer Adobe Commerce-Instanz auftreten.

Diese Befehlsoption ermöglicht es dem Upgrade-Kompatibilitäts-Tool auch, einen Ordner zu analysieren, der mehrere Module enthält:

bin/uct upgrade:check /<dir>/<instance-name> -m /vendor/<vendor-name>/

Verwandtes Lesen

  • Upgrade-Kompatibilitäts-Tool
  • Ausführen des Tools in einer Befehlszeilenschnittstelle um weitere Informationen zu den Optionen der Befehlszeilenschnittstelle zu erhalten
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f