Dokumentation

Felsöka fel i verktyg för uppgraderingskompatibilitet

17 juni 2025

I den här artikeln förklaras de fel du kan råka ut för när du använder verktyget Kompatibilitet för uppgradering och det finns lösningar för att säkerställa att det körs korrekt.

Beskrivning

Miljö

Adobe Commerce-versioner från och med 2.3.0

​1. Segmenteringsfel

Orsak: När två moduler har samma namn visas ett segmenteringsfel i uppgraderingskompatibilitetsverktyget.

2. Tomma utdata

Steg som ska återskapas:

  1. Om du har kört det här bash-kommandot:

    bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION
    
  2. Den enda utdata är Upgrade compatibility tool:

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

Orsak:

Den troliga orsaken är en minnesbegränsning för PHP.

Det finns två möjliga lösningar för att undvika denna minnesbegränsning för PHP.

Upplösning

Lösning för segmenteringsfel:

För att undvika det här felet bör du ange sökvägen till modulen som ett argument:

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

Varning: Kompatibilitetsverktyget för uppgradering kanske inte kan analysera kodbasen om den innehåller cirkelberoende mellan metoder.

Lösningar för tomma utdata:

Lösning 1:

Åsidosätt minnesbegränsningen genom att ange memory_limit till -1:

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

Obs!: M2_VERSION är den Adobe Commerce-målversion som du vill jämföra med din Adobe Commerce-instans.

Lösning 2:

Om du lägger till alternativet -m kan verktyget Kompatibilitet för uppgradering analysera varje enskild modul för att undvika att stöta på två moduler med samma namn i din Adobe Commerce-instans.

Med det här kommandoalternativet kan du även analysera en mapp som innehåller flera moduler med verktyget Kompatibilitet för uppgradering:

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

Relaterad läsning

  • Kompatibilitetsverktyg för uppgradering
  • Kör verktyget i ett kommandoradsgränssnitt om du vill ha mer information om gränssnittsalternativ på kommandoraden
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f