주 콘텐츠로 건너뛰기
버전: 1.x

PRODUCT201: 상품 이미지 사용 불가

이것이 의미하는 바

이 상품 이미지를 사용할 수 없지만 상품은 계속 판매할 수 있습니다.

이미지 없이 판매를 계속하세요. WCPOS가 나중에 이미지를 다시 불러옵니다.

조치 방법

계속 작업해도 됩니다. WCPOS가 자동으로 처리합니다. WCPOS가 자동으로 재시도합니다.

내 데이터

주문이나 상품 데이터에는 영향이 없습니다.

문제 해결

  1. 평소대로 판매하세요. 상품에는 영향이 없으며 이미지는 백그라운드에서 다시 시도됩니다.
  2. 특정 상품의 이미지가 계속 로드되지 않는다면 WP Admin에서 해당 상품을 열어 이미지를 다시 저장하세요. 미디어 라이브러리에서 파일이 삭제되었을 수 있습니다.
  3. 여러 이미지가 한꺼번에 실패한다면 사이트의 미디어 호스팅이나 CDN이 원인입니다. 스토어 웹사이트 자체에서 이미지가 로드되는지 확인하세요.

확인할 위치

WCPOS가 이 오류를 저장할 수 있는 경우, 오류는 이를 발생시킨 기기에 기록됩니다. 스토어 상태 → 로그(내비게이션 서랍 하단의 심박 아이콘)를 열고 이 코드가 표시된 항목을 찾아 펼치세요. 펼쳐진 행에는 알기 쉽게 설명된 원인과 오류가 발생한 시점에 수집된 컨텍스트가 표시됩니다. 스토어 요청의 경우 이 컨텍스트에 서버 자체의 오류 코드(serverCode), HTTP status 또는 endpoint가 포함될 수 있으며, 표시되는 필드는 오류가 발생한 위치에 따라 다릅니다. 문제를 신고할 때는 스크린샷 대신 로그 화면 상단의 디버그 정보 복사(휴대폰과 태블릿에서는 디버그 정보 공유)를 사용하세요. 여기에는 앱 버전, 연결 상태, 가장 최근의 오류가 함께 담깁니다. 로그는 최대 30일간만 보관되므로 문제가 발생한 직후에 수집하세요. 또한 POS가 자체 로그 항목을 기록하기 전에 나타난 브라우저 콘솔 오류가 있다면 함께 복사하세요.

앱 내 로그 외에도 이 오류는 다음 위치에 흔적을 남길 수 있습니다:

  • 네트워크 검사기(웹 및 데스크톱): 개발자 도구를 여세요. 브라우저에서는 F12를 누르고, 데스크톱 앱에서는 메뉴의 고급 → 개발자 도구 전환을 선택한 다음 네트워크 탭을 선택하세요. 먼저 이 페이지의 재시도 안내를 따르고, 안전하다고 안내된 경우에만 해당 작업을 재현하세요. 실패한 요청에는 HTTP 상태와 원시 응답 본문이 표시되며, 여기에는 POS 로그에 전혀 도달하지 않는 오류 페이지도 포함됩니다.

세부 정보

  • 코드: PRODUCT201 (PRODUCT_IMAGE_UNAVAILABLE)
  • 심각도: warn
  • 도입 버전: WCPOS 1.10.0