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

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>/