설명서Experience Cloud KCS

Adobe Commerce 배포 중 패치에 오류가 없습니다.

마지막 업데이트: 2026년 8월 14일

업그레이드 후 패치를 찾을 수 없음​오류가 발생하여 Adobe Commerce 배포 또는 수동 패치 응용 프로그램이 실패합니다. 환경에서 대상 Adobe Commerce 버전에 사용할 수 없는 패치를 참조하거나 지원되는 패치 버전을 인식하지 못하는 오래된 품질 패치 도구 패키지를 사용합니다. 재배포하기 전에 구성된 패치 ID를 검토하고, 대상 버전에 대한 패치 호환성을 확인하고, 지원되지 않는 패치 참조를 제거하십시오.

설명 description

환경

  • 클라우드 인프라의 Adobe Commerce
  • .magento.env.yaml 를 사용하는 배포 업그레이드
  • 품질 패치 도구(QPT)
  • 공급업체/bin/magento-patches를 사용하는 수동 패치 적용

문제/증상

  • Adobe Commerce 업그레이드 후 배포 또는 수동 패치 응용 프로그램이 실패합니다.

  • 배포 로그에는 다음과 같은 오류가 표시됩니다.

    • 다음 패치를 찾을 수 없음: MDVA-XXXXX, ACSD-XXXXX
    • 다음 패치를 찾을 수 없음: ACSD-12345

  • 로그는 status 명령을 사용하여 패치 가용성을 확인하는 것이 좋습니다.

원인

이 문제는 다음과 같은 경우에 발생합니다.

  • .magento.env.yaml에 구성된 패치 ID는 대상 Adobe Commerce 버전에서 사용할 수 없습니다.
  • 업그레이드 후에는 이전에 적용된 패치를 더 이상 적용할 수 없습니다.
  • 설치된 QPT(Quality Patches Tool) 패키지가 오래되어 새 패치 변형을 인식하지 못합니다.

해결 방법 resolution

다음 단계에 따라 문제를 해결하십시오

  1. .magento.env.yaml.의 QUALITY_PATCHES 섹션 검토

  2. 구성된 모든 패치 ID를 식별합니다.

  3. 대상 Adobe Commerce 버전과의 호환성을 위해 품질 패치 릴리스 정보에서 각 패치 ID를 확인하십시오.

  4. 필요한 패치 버전을 지원하지 않는 경우 QPT(품질 패치 도구) 패키지를 업데이트하십시오.

  5. 구성에서 지원되지 않거나 오래된 패치 ID를 제거합니다.

  6. 변경 사항을 저장하고, 업데이트된 코드를 푸시하고, 환경을 다시 배포합니다.

  7. 패치를 수동으로 적용하는 경우 다음을 실행하기 전에 패치 호환성을 확인하십시오.

    code language-none 
    vendor/bin/magento-patches apply

관련 읽기

Commerce on Cloud Infrastructure Guide의 패치 적용.

recommendation-more-help
experience-cloud-kcs-help-kbarticles