ドキュメント

アップグレード互換性ツールのエラーのトラブルシューティング

最終更新日: 2025年7月4日

この記事では、アップグレード互換性ツールの使用中に発生する可能性のあるエラーについて説明し、正常に実行されるようにソリューションを提供します。

説明

環境

Adobe Commerce 2.3.0 以降のバージョン

​1. セグメント化の失敗エラー

原因 : 2 つのモジュールの名前が同じ場合、アップグレード互換性ツールにセグメント化フォールトエラーが表示されます。

2. 空の出力

再現手順 :

  1. この bash コマンドを実行した後の場合:

    bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION
    
  2. 唯一の出力は Upgrade compatibility tool です。

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

原因 :

考えられる原因は、PHP のメモリ制限です。

この PHP のメモリ制限を回避するには、2 つの解決策が考えられます。

解決策

セグメント化障害エラーの解決策

このエラーを回避するには、モジュールへのパスを引数として指定することをお勧めします。

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

警告 : アップグレード互換性ツールは、メソッド間に循環依存関係がある場合、コードベースを分析できない可能性があります。

空の出力に対するソリューション

ソリューション 1:

memory_limit を -1 に設定して、メモリ制限を上書きし す。

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

メモ :M2_VERSION は、Adobe Commerce インスタンスと比較するターゲット Adobe Commerce バージョンです。

ソリューション 2:

-m オプションを追加すると、アップグレード互換性ツールで個々の特定のモジュールを個別に分析できるので、Adobe Commerce インスタンスで同じ名前の 2 つのモジュールが発生するのを回避できます。

また、このコマンドオプションを使用すると、アップグレード互換性ツールで、複数のモジュールを含むフォルダーを分析することもできます。

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

関連資料

  • 互換性アップグレードツール
  • コマンドラインインターフェイスでのツールの実行を参照してください
recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f