疑難排解升級相容性工具錯誤

Last update: Fri Jul 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

本文會說明使用升級相容性工具時可能遇到的錯誤，並提供解決方案以確保成功執行。

說明 description

Adobe Commerce 2.3.0以後的版本

原因：當兩個模組具有相同名稱時，升級相容性工具會顯示分段錯誤錯誤。

要再現的步驟：

如果執行這個bash指令之後：

code language-none
`bin/uct upgrade:check INSTALLATION_DIR -c M2_VERSION`

唯一的輸出為Upgrade compatibility tool：

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

原因：

可能的原因是PHP記憶體限制。

有兩種可能的解決方案可避免此PHP記憶體限制。

若要避免此錯誤，建議將模組的路徑指定為引數：

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執行個體中遇到兩個名稱相同的模組。

這個命令選項也允許升級相容性工具分析包含數個模組的資料夾：

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