설명서Commerce도구

ACP2E-4628: 대문자 이메일 주소를 사용하여 고객을 가져오면 계정 공유가 글로벌로 설정된 경우 정의되지 않은 배열 키 오류가 트리거됩니다

마지막 업데이트: 2026년 5월 11일

작성 대상:

  • Experienced
  • Admin
  • Developer

ACP2E-4628 패치는 계정 공유​가 전역(으)로 설정되어 가져오기 오류가 발생할 때 대문자 이메일 주소로 고객을 가져오면 정의되지 않은 배열 키 오류가 발생하는 문제를 해결합니다. 이 패치는 Quality Patches Tool (QPT) 1.1.78이 설치된 경우에 사용할 수 있습니다. 패치 ID는 ACP2E-4628입니다. 이 문제는 Adobe Commerce 2.4.9에서 수정됩니다.

영향을 받는 제품 및 버전

Adobe Commerce 버전에 대한 패치가 만들어졌습니다.

  • Adobe Commerce(모든 배포 방법) 2.4.8-p1

Adobe Commerce 버전과 호환:

  • Adobe Commerce(모든 배포 방법) 2.4.8 - 2.4.8-p4
NOTE
새 Quality Patches Tool 릴리스가 있는 다른 버전에 패치를 적용할 수 있습니다. 패치가 Adobe Commerce 버전과 호환되는지 확인하려면 magento/quality-patches 패키지를 최신 버전으로 업데이트하고 Quality Patches Tool에서 호환성을 확인합니다. 패치 검색 페이지. 패치 ID를 검색 키워드로 사용하여 패치를 찾습니다.

문제

대문자 이메일 주소를 글로벌 계정 공유가 활성화된 상태로 사용하면 고객 가져오기가 실패하고 정의되지 않은 배열 키 오류가 발생합니다.

재현 단계:

  1. Stores > 설정 > 구성 > Customers > Customer Configuration > Account Sharing Options(으)로 이동합니다.

    1. Share Customer Accounts​을(를) 전역(으)로 설정합니다.

  2. System > Export > Customer Main File(으)로 이동하여 기존 고객을 내보냅니다.

  3. System > Import > Customer Main File(으)로 이동합니다.

    1. 복잡한 데이터를 추가/업데이트하도록 Import Behavior을(를) 설정합니다.
    2. 변경하지 않고 내보낸 파일을 업로드합니다.

  4. Check Data 단추를 클릭합니다.

예상 결과:

이메일 주소에 대문자가 포함되어 있고 계정 공유가 글로벌로 설정된 경우에도 고객 가져오기는 오류 없이 정상적으로 완료되어야 합니다.

실제 결과:

가져오기가 실패하고 다음 오류가 발생합니다.

Warning: Undefined array key "Uppercase.Email@example.com" in app/code/Magento/CustomerImportExport/Model/ResourceModel/Import/Customer/Storage.php on line 117

패치 적용

개별 패치를 적용하려면 배포 방법에 따라 다음 링크를 사용합니다.

관련 읽기

Quality Patches Tool에 대한 자세한 내용은 다음을 참조하세요.

recommendation-more-help
commerce-operations-help-tools