Dépannage Commerce Version Tool

Utilisez cette page pour résoudre les problèmes courants de Commerce Version Tool (CVT) liés à la détection du compositeur, au chargement du registre, à la détection des correctifs d’exécution à sec internes, à la génération de sortie et à la journalisation d’audit.

Étapes de dépannage rapide

Si l’outil de CVT ne renvoie pas le rapport d’état du correctif attendu :

Problèmes courants et solutions

Impossible de détecter la version de base

Si l’outil CVT ne parvient pas à trouver la version de base d’Adobe Commerce, vérifiez les conditions suivantes :

Vérifier :

Messages d’avertissement :

Si composer.lock existe mais qu’il est illisible, impossible à analyser ou ne contient pas de package de base reconnu, l’outil émet l’une des chaînes suivantes dans le champ de sortie des avertissements :

No recognized Commerce base package found in composer.lock
composer.lock exists but could not be read
composer.lock could not be parsed as JSON

L’une des conditions mentionnées précédemment indique que l’outil ne peut pas détecter la version de base. L’outil se ferme avec le code 1 et aucune détection de correctif n’est effectuée.

Actions:

Aucun correctif ne s’applique à la version installée

Si CVT signale un base_version valide, mais que les applied_patches, missing_patches et unknown_patches sont vides, la version installée n’est pas couverte par le registre des correctifs actuel.

Vérifier :

Messages d’avertissement :

No patches found in registry for installed component versions (CE=2.4.7-p9)

Cet avertissement est différent de l’avertissement « la version de base ne peut pas être détectée ». La base_version est correcte, l’outil se ferme 0 et il n’y a rien dans le registre auquel comparer.

Actions:

Impossible de récupérer le registre des correctifs

Si l’outil CVT ne parvient pas à récupérer le dernier fichier de registre des correctifs, vérifiez les paramètres réseau et de cache :

Vérifier :

Messages d’avertissement :

L’outil émet les chaînes suivantes dans le champ de sortie des avertissements pour ce scénario :

Remote registry fetch failed (HTTP 403). Check PATCH_REGISTRY_URL (if set) and network connectivity.
Remote registry response was not valid JSON; ignoring.
Could not load remote registry. Using cached registry (3 hours old). CVE coverage may be incomplete.
Patch registry could not be loaded.
Could not fetch remote registry and --no-cache was set; aborting.

Le message du cache obsolète inclut l’âge réel en heures, par exemple, (3 hours old).

Les avertissements patch registry could not be loaded et could not fetch remote registry indiquent que l’outil s’est arrêté sans exécuter la détection de correctif.

Actions:

La comparaison des correctifs ne peut pas être récupérée ni vérifiée.

Si l’outil CVT ne peut pas tester un ou plusieurs correctifs applicables, vérifiez l’accès à patch-diff :

Vérifier :

Messages d’avertissement :

L’outil émet les chaînes suivantes dans le champ de sortie des avertissements pour ce scénario :

Patch 247p9-2026-05-001-EE requires authentication. Set credentials via COMPOSER_AUTH or auth.json.
Could not fetch patch 247p9-2026-05-001-EE (HTTP 401). Check credentials (COMPOSER_AUTH / auth.json).
Could not fetch patch 247p9-2026-05-001-EE (HTTP 404).
Could not fetch or verify patch 247p9-2026-05-001-EE. Check network connectivity and credentials (COMPOSER_AUTH / auth.json).
Could not fetch patch file for 247p9-2026-05-001-EE.
SHA-256 verification failed for patch 247p9-2026-05-001-EE; discarding download.

L’ID de correctif dans chaque message est l’ID d’entrée de registre réel, par exemple 247p9-2026-05-001-EE. SHA-256 verification failed signifie qu’un fichier correctif récemment téléchargé ne correspond pas à sa somme de contrôle attendue. L’outil le supprime sans mise en cache et classe le correctif unknown pour cette exécution. Une entrée de cache locale corrompue est détectée et récupérée silencieusement au cours de la même exécution, sans avertissement. Dans les deux cas, aucun nettoyage manuel du cache n’est nécessaire.

Actions:

Des correctifs manquants ou inconnus sont signalés

Si le rapport contient des valeurs missing_patches ou unknown_patches inattendues, consultez les détails de l’installation et de la sortie :

Vérifier :

Messages d’avertissement :

L’outil émet les chaînes suivantes dans le champ de sortie des avertissements pour ce scénario :

No file_name or sha256 for 247p9-2026-05-001-EE
Registry entry '247p9-2026-05-001-EE' requires unknown patch '247p9-2026-04-001-EE'; skipping.
descendant diffs unavailable for 247p9-2026-06-001-EE; dry-run for 247p9-2026-05-001-EE may be inaccurate
Failed to reverse-apply 247p9-2026-06-001-EE when preparing dry-run for 247p9-2026-05-001-EE; result may be inaccurate
Failed to forward-apply prerequisite 247p9-2026-04-001-EE when preparing dry-run for 247p9-2026-05-001-EE; result may be inaccurate

Lorsque vous rencontrez des may be inaccurate dans un avertissement, la vérification d’essai s’exécute toujours, mais avec un degré de confiance réduit. Le correctif peut toujours être classé en applied_patches ou missing_patches, mais pas nécessairement unknown_patches.

Pour les correctifs inconnus en particulier, var/log/patch_status.log enregistre la sortie d’exécution d’essai de correctifs bruts (direct et inverse), qui indique quels fichiers et quels blocs n’ont pas pu correspondre.

Si vous rencontrez un avertissement indiquant qu’aucun correctif n’a été trouvé, reportez-vous à la section aucun correctif ne s’applique à la version installée pour obtenir des conseils.

Actions:

La sortie n’est pas générée.

Si l’outil CVT se termine mais que la sortie JSON ou CSV attendue est manquante, vérifiez la syntaxe de la commande et la sortie du terminal :

Actions:

Obtention d’aide

Lorsque vous contactez l’assistance Adobe Commerce, fournissez uniquement les détails nécessaires pour examiner le problème.

Inclure :

N’incluez pas de secrets, d’informations d’identification, de clés privées ou de données client non liées dans les pièces jointes ou les journaux partagés.

Rubriques connexes