Commerce Version Tool 문제 해결

이 페이지에서는 작성기 감지, 레지스트리 로드, 내부 시험 실행 패치 감지, 출력 생성 및 감사 로깅과 관련된 일반적인 Commerce Version Tool​(CVT) 문제를 해결할 수 있습니다.

빠른 문제 해결 단계

CVT 도구가 필요한 패치 상태 보고서를 반환하지 않는 경우:

일반적인 문제 및 솔루션

기본 버전을 검색할 수 없음

CVT 도구가 Adobe Commerce 기본 버전을 찾을 수 없는 경우 다음 조건을 확인하십시오.

확인:

경고 메시지:

composer.lock이(가) 있지만 읽을 수 없거나 구문 분석할 수 없거나 인식되는 기본 패키지가 들어 있지 않으면 도구에서 경고 출력 필드에 다음 문자열 중 하나를 표시합니다.

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

이전에 언급된 모든 조건은 도구가 기본 버전을 감지할 수 없음을 나타냅니다. 도구가 코드 1(으)로 종료되고 패치 검색이 수행되지 않습니다.

작업:

설치된 버전에 적용되는 패치 없음

CVT에서 올바른 base_version을(를) 보고했지만 applied_patches, missing_patches 및 unknown_patches이(가) 비어 있으면 설치된 버전이 현재 패치 레지스트리에서 적용되지 않습니다.

확인:

경고 메시지:

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

이 경고는 "기본 버전을 감지할 수 없음"과 다릅니다. base_version이(가) 올바르고 도구가 0을(를) 종료했으며 레지스트리에 비교할 대상이 없습니다.

작업:

패치 레지스트리를 가져올 수 없음

CVT 도구가 최신 패치 레지스트리 파일을 가져올 수 없는 경우 네트워크 및 캐시 설정을 확인하십시오.

확인:

경고 메시지:

이 도구는 이 시나리오의 경고 출력 필드에 다음 문자열을 내보냅니다.

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.

부실 캐시 메시지에 실제 사용 기간(시간)이 포함됩니다(예: (3 hours old)).

patch registry could not be loaded 및 could not fetch remote registry 경고는 패치 검색을 실행하지 않고 도구가 종료되었음을 나타냅니다.

작업:

패치 차이를 가져오거나 확인할 수 없음

CVT 도구가 적용 가능한 패치를 하나 이상 테스트할 수 없는 경우 패치 비교 액세스를 확인하십시오.

확인:

경고 메시지:

이 도구는 이 시나리오의 경고 출력 필드에 다음 문자열을 내보냅니다.

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.

각 메시지의 패치 ID는 실제 레지스트리 항목 ID입니다(예: 247p9-2026-05-001-EE). SHA-256 verification failed은(는) 새로 다운로드한 패치 파일이 필요한 체크섬과 일치하지 않음을 의미합니다. 이 도구는 캐싱 없이 삭제하고 이 실행에 대해 패치 unknown을(를) 분류합니다. 손상된 local 캐시 항목이 검색되었으며 경고 없이 동일한 실행 내에서 자동으로 다시 가져옵니다. 두 경우 모두 수동 캐시 정리가 필요하지 않습니다.

작업:

누락되었거나 알 수 없는 패치가 보고됨

보고서에 예기치 않은 missing_patches 또는 unknown_patches 값이 포함된 경우 설치 및 출력 세부 정보를 검토하십시오.

확인:

경고 메시지:

이 도구는 이 시나리오의 경고 출력 필드에 다음 문자열을 내보냅니다.

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

경고에 may be inaccurate이(가) 발생하면 시험 실행 검사가 계속 실행되지만 신뢰도가 저하됩니다. 패치는 unknown_patches일 필요는 없지만 applied_patches 또는 missing_patches에서 계속 분류할 수 있습니다.

특히 알 수 없는 패치의 경우 var/log/patch_status.log은(는) 일치하지 않는 파일과 청크를 나타내는 원시 패치 드라이 실행 출력(정방향 및 역방향)을 기록합니다.

“패치를 찾을 수 없음” 경고가 발생하면 설치된 버전에 적용된 패치가 없음을 참조하세요.

작업:

출력이 생성되지 않음

CVT 도구가 완료되었지만 필요한 JSON 또는 CSV 출력이 누락된 경우 명령 구문 및 터미널 출력을 확인하십시오.

작업:

도움말 보기

Adobe Commerce 지원에 문의할 때 문제를 조사하는 데 필요한 세부 정보만 제공하십시오.

포함:

공유 로그 또는 첨부 파일에 비밀, 자격 증명, 비공개 키 또는 관련 없는 고객 데이터를 포함하지 마십시오.

관련 항목