업그레이드 호환성 도구 오류 문제 해결

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

이 문서에서는 업그레이드 호환성 도구를 사용하는 동안 발생할 수 있는 오류에 대해 설명하고 도구를 성공적으로 실행할 수 있도록 이러한 오류를 해결하는 솔루션을 제공합니다.

영향을 받는 제품 및 버전

원인:

두 모듈의 이름이 같은 경우 업그레이드 호환성 도구에 세그멘테이션 오류 오류가 표시됩니다.

솔루션:

이 오류를 방지하려면 모듈의 경로를 인수로 지정하는 것이 좋습니다.

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

WARNING

업그레이드 호환성 도구는 메서드 간 순환 종속성이 포함된 경우 코드 베이스를 분석하지 못할 수 있습니다.

재현 단계:

이 명령을 실행한 후 다음과 같은 경우:

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

출력만 Upgrade compatibility tool입니다.

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

원인:

가능한 원인은 PHP 메모리 제한입니다.

이 PHP 메모리 제한을 피하기 위한 두 가지 가능한 해결책이 있습니다.

솔루션 1:

memory_limit을(를) -1(으)로 설정하여 메모리 제한을 재정의합니다.

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

NOTE

M2_VERSION은(는) Adobe Commerce 인스턴스와 비교할 대상 Adobe Commerce 버전입니다.

솔루션 2:

-m 옵션을 추가하면 업그레이드 호환성 도구에서 각 특정 모듈을 독립적으로 분석하여 Adobe Commerce 인스턴스에서 이름이 같은 두 모듈이 발생하지 않도록 할 수 있습니다.

또한 이 명령 옵션을 사용하면 업그레이드 호환성 도구에서 여러 모듈이 포함된 폴더를 분석할 수 있습니다.

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

명령줄 인터페이스 옵션에 대한 자세한 내용은 명령줄 인터페이스에서 도구 실행 페이지를 참조하십시오.

recommendation-more-help

8bd06ef0-b3d5-4137-b74e-d7b00485808a