SYNC131: 스토어 서버 오류
이것이 의미하는 바
스토어가 오류를 반환하여 이 작업이 완료되지 않았습니다.
스토어에는 연결되었지만 서버가 요청을 처리하지 못했습니다. 이는 POS가 아니라 웹사이트의 문제이므로 재시도만으로는 해결되지 않을 수 있습니다. 사이트의 오류 로그를 확인하거나 호스트에게 확인을 요청한 다음 재시도하세요. 이 기기에서 손실된 것은 없습니다.
조치 방법
해당 작업을 다시 시도하세요. WCPOS는 이 작업을 자동으로 재시도하지 않습니다. 준비되면 직접 재시도하세요.
내 데이터
변경 사항은 이 기기에 저장되었지만 스토어에는 전달되지 않았습니다. 이 문제가 계속되면 진단 정보를 내보내고 WCPOS 지원팀에 문의하세요.
문제 해결
- 로그 항목을 펼쳐 status, endpoint, serverCode를 기록해 두세요. 서버가 실패한 시점에 무엇을 하고 있었는지 알려 줍니다.
- 사이트에서 WooCommerce → 상태 → 로그를 열고 오류 발생 시각 전후의 최신 fatal-errors 로그를 확인하세요. 500번대 응답은 거의 항상 그곳에 PHP 오류를 남깁니다.
- 사이트에서 플러그인, 테마 또는 PHP를 업데이트한 후부터 오류가 시작되었다면 그 변경을 가장 먼저 의심하고 되돌리거나 비활성화하세요.
- WooCommerce 로그에 아무것도 없다면 같은 시간대의 서버 PHP 오류 로그를 호스팅 제공업체에 요청하세요.
- 서버 측 원인이 해결되면 POS에서 재시도하세요. 변경 사항은 여전히 이 기기에 저장되어 있습니다.
확인할 위치
WCPOS가 이 오류를 저장할 수 있는 경우, 오류는 이를 발생시킨 기기에 기록됩니다. 스토어 상태 → 로그(내비게이션 서랍 하단의 심박 아이콘)를 열고 이 코드가 표시된 항목을 찾아 펼치세요. 펼쳐진 행에는 알기 쉽게 설명된 원인과 오류가 발생한 시점에 수집된 컨텍스트가 표시됩니다. 스토어 요청의 경우 이 컨텍스트에 서버 자체의 오류 코드(serverCode), HTTP status 또는 endpoint가 포함될 수 있으며, 표시되는 필드는 오류가 발생한 위치에 따라 다릅니다. 문제를 신고할 때는 스크린샷 대신 로그 화면 상단의 디버그 정보 복사(휴대폰과 태블릿에서는 디버그 정보 공유)를 사용하세요. 여기에는 앱 버전, 연결 상태, 가장 최근의 오류가 함께 담깁니다. 로그는 최대 30일간만 보관되므로 문제가 발생한 직후에 수집하세요. 또한 POS가 자체 로그 항목을 기록하기 전에 나타난 브라우저 콘솔 오류가 있다면 함께 복사하세요.
앱 내 로그 외에도 이 오류는 다음 위치에 흔적을 남길 수 있습니다:
- 네트워크 검사기(웹 및 데스크톱): 개발자 도구를 여세요. 브라우저에서는 F12를 누르고, 데스크톱 앱에서는 메뉴의 고급 → 개발자 도구 전환을 선택한 다음 네트워크 탭을 선택하세요. 먼저 이 페이지의 재시도 안내를 따르고, 안전하다고 안내된 경우에만 해당 작업을 재현하세요. 실패한 요청에는 HTTP 상태와 원시 응답 본문이 표시되며, 여기에는 POS 로그에 전혀 도달하지 않는 오류 페이지도 포함됩니다.
- 서버 측 POS 로그: WP Admin에서 POS → 설정 → 도구 → 로그를 여세요. 이 페이지에는 서버 자체에서 발생한 POS 관련 경고와 오류가 기록되며, 이러한 항목은 앱 안에서는 전혀 표시되지 않을 수 있습니다. 메뉴에 빨간색 배지가 표시되면 읽지 않은 서버 측 오류가 있다는 뜻입니다.
- WooCommerce → 상태 → 로그: WordPress 사이트에서 가장 최근의
fatal-errors-*.log에 PHP 충돌이 있는지 확인하고, 이 오류와 관련된 플러그인 이름이 붙은 로그 소스도 함께 확인하세요. 스토어에서 발생한 500번대 오류는 거의 항상 그 원인을 여기에 남깁니다. - 사이트의 PHP 오류 로그: WooCommerce 로그 페이지에 오류 발생 시각에 대한 기록이 없다면 호스팅 제공업체에 PHP 오류 로그를 요청하세요. 일부 치명적 오류는 서버 수준에서만 기록됩니다.
세부 정보
- 코드:
SYNC131(STORE_SERVER_ERROR) - 심각도: error
- 도입 버전: WCPOS 1.10.0