학습 내용
아래에 설명된 관련 문제 해결 시나리오에 따라 WooCommerce 연동 설정 관련 문제를 해결하는 방법을 알아보세요. 이 목록에 없는 문제가 발생하면 커뮤니티나 지원팀에 문의해 주세요.
시작하기 전에시작하기 전에
아직 통합하지 않았다면 WooCommerce 시작하기 가이드를 읽고 통합에 대한 단계별 지침을 확인하세요. 플러그인을 업그레이드하려는 경우 WooCommerce 플러그인 업그레이드 방법 문서를 확인하세요.
문제 해결 시나리오문제 해결 시나리오
앱에서 수신한 오류 메시지에 따라 다음 시나리오를 참조하여 문제를 해결하세요.
통합을 제거했다가 다시 통합하도록 선택하면 클라비요에서 WooCommerce 데이터가 삭제되지 않는다는 점에 유의하세요.
"기능 장애를 방지하려면 다음 플러그인을 비활성화해야 할 수 있습니다: 플러그인 이름"
워드프레스에 활성 캐싱 플러그인이나 리디렉션 플러그인이 있는 경우 이러한 플러그인이 클라비요의 통합을 방해하고 연결 문제를 일으킬 수 있습니다. 연동 설정 과정에서 이러한 플러그인을 비활성화하는 것이 좋습니다.
"설정을 완료할 수 없습니다."
이 메시지는 방화벽이 클라비요의 요청을 차단하고 있거나, Cloudflare에서 봇 싸움 모드가 활성화되어 있 거나, 또는 둘 다라는 의미입니다.
이 문제를 해결하려면 클라비요 연동 트래픽을 허용 목록에 추가하고 봇 파이트 모드를 비활성화할 것을 권장합니다(활성화한 경우).
- 클라비요 연동 트래픽 IP 주소를 허용 목록에 추가하는 방법을 알아보세요.
- Cloudflare에서 봇 전투 모드를 비활성화하려면:
- Cloudflare 대시보드에 로그인합니다.
- 계정과 도메인을 선택합니다.
- 보안 > 봇으로 이동합니다.
- 봇 전투 모드의 경우 끄기를 선택합니다.
"WooCommerce 스토어에 https 및 SSL이 활성화되어 있는지 확인"
클라비요는 스토어 URL이 HTTPS 프로토콜을 준수해야 하며, 이는 웹사이트에 유효한 SSL 인증서가 있어야 함을 의미합니다. 웹사이트가 HTTPS가 아닌 HTTP를 사용하는 경우 문제가 발생할 수 있습니다.
SSL 서버 테스트(Qualys SSL Labs 제공)에서 SSL 인증서가 유효한지 확인할 수 있습니다.
클라비요는 A 등급으로 테스트를 통과해야 합니다.
"제공된 자격 증명으로 API에 액세스할 수 없습니다.""제공된 자격 증명으로 API에 액세스할 수 없습니다."
로그인하지 않은 사용자의 API 액세스를 차단하는 사용자 지정이 있는 경우 이 오류가 표시될 수 있습니다. 일반적으로 이 함수는 401 상태 코드 응답을 트리거하는 functions.php 워드프레스 파일에 있는 함수입니다.
이와 같은 사용자 정의가 있는 경우 삭제하거나 댓글을 달아 오류를 제거하세요. 이 오류에 대한 자세한 내용은 WooCommerce REST API FAQ를 참조하세요.
"주문 API에 액세스할 수 없습니다. 연결 설정을 확인한 후 다시 시도하세요.""주문 API에 액세스할 수 없습니다. 연결 설정을 확인한 후 다시 시도하세요."
이 오류는 클라비요가 WooCommerce 통합의 유효성을 검사하고 주문 수를 가져오려고 할 때 API가 클라비요가 기대하는 값을 반환하지 않거나 전혀 반환하지 않는 것을 의미합니다.
아직 공식적으로 클라비요에 연결되지 않았으므로 WooCommerce 내에서 이 문제를 해결해야 합니다.
이 오류에 대한 자세한 정보를 얻으려면 주문 수 엔드포인트에 대한 API 호출을 수행하면 클라비요에 전달되는 내용에 대한 더 많은 인사이트를 얻을 수 있습니다. 다음은 cURL 요청 예시입니다. 사용하려면 스토어 URL, 소비자 키, 소비자 비밀번호를 입력합니다:
curl https://STORE_URL/wp-json/wc/v3/orders \
-u CONSUMER_KEY:CONSUMER_SECRET
"클라비요 플러그인이 오래되었습니다."
간혹 웹훅이 클라비요에 도달하는 데 지연이 발생하여 일시적으로 이전 설정 페이지가 표시되는 경우가 있습니다. 이 문제는 몇 분 후에 저절로 해결됩니다.
워드프레스에서 클라비요에 연결할 때 404 발생워드프레스에서 클라비요에 연결할 때 404 발생
이 문제를 해결하려면 워드프레스 사이트에 퍼머링크가 활성화되어 있는지 확인해야 합니다. 퍼머링크가 활성화되어 있지 않으면 WooCommerce 인증이 작동하지 않습니다.
- 워드프레스 사이트로 이동하여 설정 > 퍼머링글로 이동합니다.
- 일반 설정에서"일반" 이외의 링크 구조를 선택합니다.
-
변경 사항 저장을 클릭하여 확인합니다.
- 완료되면 클라비요와 다시 통합합니다.