WooCommerce 장바구니 담기 버튼이 작동하지 않습니다. 어떻게 해결해야 할까요?

WooCommerce의 '장바구니에 담기' 버튼은 모든 상품 페이지에서 가장 중요한 요소입니다. 이 버튼이 작동하지 않으면 쇼핑몰에서 주문을 처리할 수 없게 됩니다. 오류가 발생한 상품 페이지에 방문하는 모든 고객은 곧 판매 손실로 이어집니다.

베이마드 연구소의 보고서에 따르면 온라인 쇼핑객의 17%가 웹사이트 오류로 인해 구매를 포기하는 것으로 나타났습니다. '장바구니에 담기' 버튼이 작동하지 않거나 아예 없는 경우, 이는 바로 이러한 오류에 해당하며 제품 페이지 방문자 전체(100%)에게 영향을 미칩니다.

해결 방법은 오류 유형에 따라 다릅니다. 버튼이 전혀 보이지 않는 경우, 버튼은 나타나지만 클릭해도 아무 반응이 없는 경우, 또는 장바구니에 담기는 하지만 페이지가 업데이트되지 않는 경우와 원인은 각각 다릅니다. 어떤 오류인지 진단해야 어떤 해결 방법을 먼저 적용해야 할지 결정할 수 있습니다.

이 가이드는 모든 원인과 해결 방법을 다루며, 어떤 문제를 먼저 배제해야 하는지 순서대로 정리되어 있습니다.

먼저 고장 유형을 진단하세요

장바구니 담기 버튼 관련 문제는 모두 동일한 것은 아닙니다. 해결 방법은 발생한 오류 유형에 따라 다릅니다.

고장 유형	당신이 보는 것	가장 유력한 원인
버튼이 표시되지 않음	제품 페이지는 로드되지만 버튼이 나타나지 않습니다	제품 데이터 누락, 재고 부족 설정 및 테마 문제
버튼을 클릭할 수 없습니다	버튼은 나타나지만 클릭해도 아무 일도 일어나지 않습니다	자바스크립트 오류, 테마 충돌, 플러그인이 스크립트를 차단함
버튼을 추가했지만 페이지가 업데이트되지 않았습니다	회전판이 나타났다가 멈추고, 장바구니 개수는 변하지 않습니다	캐싱 또는 보안 플러그인으로 인해 AJAX가 차단되었습니다
버튼이 잘못된 위치로 이동합니다	클릭하면 고객이 잘못된 페이지로 이동합니다	퍼머링크 설정 오류, 장바구니 페이지가 할당되지 않았습니다
이 버튼은 일부 제품에서는 작동하지만 다른 제품에서는 작동하지 않습니다	문제는 제품별로 다릅니다	불완전한 제품 데이터, 가변적인 제품 구성 오류

이 표를 사용하여 오류 유형을 파악한 다음, 특정 상황에 가장 적합할 가능성이 높은 해결 방법부터 시작하십시오.

WooCommerce 장바구니 담기 버튼 오류의 세 가지 유형

잘못된 해결 방법을 적용하면 시간이 낭비될 뿐만 아니라 새로운 문제가 발생할 수 있습니다. 아래 해결 방법을 시도하기 전에 발생한 오류 유형을 먼저 파악하십시오.

버튼이 전혀 표시되지 않습니다

상품 페이지에 '장바구니에 담기' 버튼이 전혀 보이지 않는 경우, WooCommerce에서 의도적으로 숨기거나 테마에서 해당 버튼을 제대로 표시하지 않는 것일 수 있습니다.

WooCommerce는 다음과 같은 상황에서 '장바구니에 담기' 버튼을 자동으로 숨깁니다

• 해당 제품에는 가격이 책정되지 않았습니다

• 해당 제품은 품절로 표시되어 있으며, 품절 상품을 숨기는 스토어 설정이 활성화되어 있습니다

• 가변 상품에 구성된 변형이 없거나 모든 변형이 품절되었습니다

• 외부/제휴 제품에는 외부 URL이 구성되어 있지 않습니다

기술적인 문제라고 생각하기 전에 다음 제품 수준 설정을 확인하세요. WooCommerce에서 제품 편집 페이지로 이동하여 제품 데이터 패널에 가격이 입력되어 있는지, 재고 상태가 '재고 있음'으로 표시되어 있는지, 또는 품절 설정이 의도한 대로 구성되어 있는지 확인하세요. 또한, 가변 상품의 경우 최소 하나 이상의 변형 상품이 존재하고 재고가 있는지 확인하세요.

버튼은 표시되지만 클릭할 수 없습니다

버튼이 나타나지만 클릭에 반응하지 않는 경우, JavaScript 오류로 인해 클릭 핸들러가 실행되지 않는 것입니다. 버튼은 HTML에 렌더링되지만 스크립트 충돌이나 오류로 인해 기능이 제대로 작동하지 않습니다.

브라우저 개발자 콘솔(Chrome에서는 F12 키를 누른 다음 콘솔 탭)을 열고 제품 페이지를 새로 고침하세요. '장바구니에 담기' 버튼을 클릭하고 콘솔에서 빨간색 오류 메시지를 확인하세요. 일반적인 JavaScript 오류는 구체적인 원인을 나타냅니다

• jQuery가 정의되지 않았습니다. jQuery가 로드되지 않거나 순서대로 로드되지 않는 경우입니다. 최적화 플러그인이 jQuery 로드를 지연시키는 경우에 자주 발생합니다.

• undefined의 속성을 읽을 수 없습니다. WooCommerce JavaScript 함수가 종속성이 준비되기 전에 실행되고 있습니다. 일반적으로 플러그인 충돌로 인해 발생합니다.

• AJAX URL이 정의되지 않았습니다 / wc_add_to_cart_params가 정의되지 않았습니다: WooCommerce의 장바구니 매개변수가 페이지에 출력되지 않습니다. 일반적으로 캐싱 플러그인이 WooCommerce의 JavaScript 없이 캐시된 버전의 페이지를 제공하는 경우에 발생합니다.

진행하기 전에 구체적인 오류 메시지를 확인하십시오. 오류 메시지를 보면 어떤 해결 방법을 적용해야 하는지 정확히 알 수 있습니다.

버튼을 클릭했지만 장바구니가 업데이트되지 않습니다

버튼을 클릭해도 장바구니에 상품이 추가되지 않고 상품 개수도 업데이트되지 않는 경우(클릭이 인식되고 로딩 스피너가 나타나는 경우) AJAX 요청이 실패한 것입니다. WooCommerce는 페이지 새로 고침 없이 상품을 장바구니에 추가하기 위해 AJAX를 사용합니다. AJAX 요청이 차단되거나 실패하면 클릭이 아무런 효과가 없는 것처럼 보입니다.

이는 일반적으로 캐싱 플러그인이 AJAX 요청에 대한 캐시된 응답을 제공하거나, 보안 플러그인이 의심스러운 것으로 분류한 AJAX 호출을 차단하거나, WooCommerce 설정에서 AJAX URL 구성이 잘못된 경우에 발생합니다.

 

해결 방법 1: WooCommerce, WordPress 및 모든 플러그인을 업데이트하세요

오래된 소프트웨어는 가장 쉽게 배제할 수 있는 문제이면서도 가장 흔히 간과되는 부분입니다. 특히 최근 업데이트 이후 버튼이 작동하지 않는 경우라면, 다른 해결 방법을 시도하기 전에 먼저 소프트웨어 문제부터 확인해 보세요.

오래된 소프트웨어가 장바구니 담기 버튼을 작동시키지 못하는 이유는 무엇일까요?

WooCommerce, WordPress, 테마 및 플러그인은 자주 업데이트됩니다. 한 구성 요소가 업데이트되었는데 다른 구성 요소가 그에 맞춰 업데이트되지 않으면 호환성 문제가 발생합니다. '장바구니에 담기' 버튼은 WordPress 코어, WooCommerce, 현재 사용 중인 테마, 그리고 제품 또는 장바구니 동작을 수정하는 플러그인 등 여러 구성 요소가 서로 연동되어야 작동합니다. 이 연결 고리 중 어느 한 부분이라도 버전이 일치하지 않으면 전체 연결이 끊어지게 됩니다.

이는 업데이트 직후 '장바구니에 담기' 버튼이 작동하지 않는 가장 흔한 원인입니다. 만약 버튼이 업데이트 전에는 정상적으로 작동하다가 최근 업데이트 이후 작동하지 않는다면, 거의 확실히 호환성 문제일 가능성이 높습니다.

모든 것을 안전하게 업데이트하는 방법

업데이트하기 전에 백업을. 워드프레스 관리자 페이지에서 대시보드 > 업데이트로 이동합니다. 먼저 워드프레스 코어를 업데이트하고, 그 다음 모든 플러그인을 업데이트합니다. 마지막으로 테마를 업데이트하세요.

특히 WooCommerce의 경우, 주요 버전 업데이트(4.x에서 5.x, 5.x에서 6.x)에서 호환성이 깨지는 변경 사항이 발생할 수 있습니다. 따라서 주요 WooCommerce 업데이트를 프로덕션 환경에 적용하기 전에 항상 스테이징 환경 .

업데이트 후 캐싱 플러그인을 사용 중이라면 사이트 캐시를 삭제하세요 . 그런 다음 제품 페이지에서 '장바구니에 담기' 버튼이 제대로 작동하는지 확인한 후 문제가 해결되었는지 판단하세요.

업데이트 후 버튼이 작동하지 않을 경우 어떻게 해야 하나요?

특정 업데이트 직후 버튼이 작동하지 않는다면, 해당 업데이트가 원인일 가능성이 가장 높습니다. WP Rollback 플러그인을 리거나 업데이트 이전 백업 파일을 복원하세요. 그런 다음 플러그인의 변경 로그와 지원 포럼에서 동일한 문제가 보고된 사례가 있는지 확인한 후 다시 업데이트하십시오.

해결 방법 2: 플러그인 및 테마 충돌 해결

플러그인과 테마의 충돌은 장바구니 담기 버튼이 작동하지 않는 가장 흔한 원인입니다. 다음 단계를 순서대로 진행하고, 각 단계를 완료한 후 다음 단계로 넘어가기 전에 테스트하십시오.

플러그인 충돌을 식별하는 방법

플러그인 충돌은 장바구니 담기 버튼이 작동하지 않는 가장 흔한 원인입니다. 플러그인 충돌을 가장 빠르게 확인하는 방법은 WooCommerce를 제외한 모든 플러그인을 비활성화하고 버튼을 테스트하는 것입니다.

플러그인 > 설치된 플러그인으로 이동합니다. WooCommerce를 제외한 모든 플러그인을 선택합니다. 일괄 작업 드롭다운에서 비활성화를 선택합니다. 적용을 클릭합니다.

장바구니 담기 버튼을 테스트해 보세요. 이제 버튼이 작동한다면, 비활성화된 플러그인이 문제의 원인일 가능성이 높습니다. 플러그인을 하나씩 다시 활성화하고, 각 플러그인을 활성화한 후 버튼을 테스트해 보세요. 버튼이 다시 작동하지 않으면 가장 최근에 다시 활성화한 플러그인이 충돌을 일으키는 원인입니다.

실제 운영 중인 스토어에서 모든 플러그인을 비활성화할 수 없는 경우, 스테이징 환경을 사용하여 이 테스트를 재현하십시오.

장바구니 담기 버튼과 충돌하는 일반적인 플러그인

장바구니 담기 버튼 충돌의 대부분은 특정 플러그인 카테고리에서 발생합니다

캐싱 플러그인: WP Rocket, W3 Total Cache, WP Super Cache. 이러한 플러그인은 WooCommerce JavaScript를 캐싱하여 AJAX 기능을 손상시킬 수 있습니다. 해결 방법: WooCommerce 페이지를 캐싱에서 제외하세요. WP Rocket에서는 WooCommerce 페이지(장바구니, 결제, 내 계정)가 자동으로 제외되지만, WP Rocket > 설정 > 캐시 > 다음 URL을 캐시하지 않도록 설정에서 확인하세요.

최적화 플러그인: Autoptimize, Perfmatters, Asset CleanUp. 이러한 플러그인은 JavaScript 파일을 최소화하고 병합합니다. WooCommerce 스크립트를 다른 스크립트와 잘못 병합하면 jQuery 종속성 오류가 발생합니다. 해결 방법: Autoptimize에서 설정 > JavaScript 옵션으로 이동하여 "JavaScript를 헤더에 강제로 표시"를 활성화합니다. "Autoptimize에서 스크립트 제외"를 선택하고 제외 목록에 woocommerce.js와 add-to-cart.js를 추가합니다.

보안 플러그인: Wordfence, Sucuri, iThemes Security. 일부 보안 설정에서 WooCommerce의 AJAX 요청을 악성으로 분류하여 차단할 수 있습니다. 해결 방법: Wordfence에서 방화벽 > 방화벽 옵션으로 이동하여 WooCommerce AJAX 엔드포인트(wp-admin/admin-ajax.php)를 허용 목록에 추가하세요.

페이지 빌더: Elementor, Divi, WPBakery. 일부 페이지 빌더는 WooCommerce 템플릿을 덮어쓰거나 제품 페이지에 충돌하는 스크립트를 삽입할 수 있습니다. 해결 방법: 기본 WooCommerce 제품 템플릿으로 일시적으로 전환하여 테스트해 보세요.

주제 충돌을 식별하는 방법

플러그인 충돌 문제가 없는지 확인한 후, 스토어프론트 테마(WooCommerce의 공식 기본 테마)로 전환하여 버튼을 테스트해 보세요. 스토어프론트 테마 는 WooCommerce에 맞춰 특별히 설계되었으므로 호환성 문제가 전혀 없습니다.

외관 > 테마 > 새 테마 추가로 이동하여 'Storefront'를 검색하세요. 설치하고 활성화하세요. 다른 설정은 변경하지 마세요. 장바구니 담기 버튼을 테스트해 보세요.

스토어프론트에서 버튼이 정상적으로 작동한다면, 문제는 현재 사용 중인 테마에 있습니다. 테마 개발자에게 문제를 보고하고 문의하세요. 스토어프론트에서 버튼이 작동하지 않는다면, 테마와는 관련이 없는 문제입니다.

해결 방법 3: JavaScript 및 AJAX 오류 수정

JavaScript 및 AJAX 오류로 인해 다른 모든 설정이 올바르게 되어 있어도 버튼이 제대로 표시되지 않을 수 있습니다. 변경하기 전에 먼저 브라우저 콘솔에서 어떤 스크립트가 오류를 일으키는지 확인하십시오.

브라우저에서 자바스크립트 오류를 ​​확인하는 방법

Chrome 또는 Firefox에서 사이트를 엽니다. F12 키를 눌러 개발자 도구를 엽니다. 콘솔 탭을 클릭합니다. 장바구니 담기 버튼이 작동하지 않는 제품 페이지로 이동합니다.

빨간색 오류 메시지를 찾으세요. 이 메시지는 버튼 오작동을 일으키는 특정 JavaScript 오류를 나타냅니다. 전체 오류 메시지를 복사하세요. WooCommerce 지원 포럼과 플러그인 지원 포럼에서 해당 메시지를 검색해 보세요. 대부분의 일반적인 오류에는 해결 방법이 문서화되어 있습니다.

콘솔이 열려 있는 동안 네트워크 탭도 확인하세요. '장바구니에 담기' 버튼을 클릭하고 요청을 관찰하세요. 실패한 AJAX 요청은 상태 코드와 함께 빨간색으로 표시됩니다. 403 상태 코드는 보안 플러그인이 요청을 차단하고 있음을 나타냅니다. 500 상태 코드는 AJAX 처리기에서 서버 오류가 발생했음을 나타냅니다.

WooCommerce에서 AJAX 장바구니 추가 설정 문제를 해결하세요

WooCommerce > 설정 > 제품으로 이동합니다. 장바구니 추가 동작 섹션을 찾습니다. 아카이브 페이지에서 AJAX 장바구니 추가 버튼 활성화가 선택되어 있는지 확인합니다. 이 설정은 상점 및 카테고리 페이지에서 AJAX 장바구니 기능을 활성화할지 여부를 제어합니다.

또한 장바구니 및 결제 페이지가 올바르게 지정되었는지 확인하십시오. WooCommerce > 설정 > 고급 > 페이지 설정으로 이동하여 장바구니 및 결제 페이지가 사이트의 올바른 페이지로 설정되어 있는지 확인하세요. 페이지가 비어 있거나 잘못된 페이지로 설정된 경우 장바구니 버튼 클릭이 오류 메시지 없이 실패합니다.

WooCommerce 스크립트 오류를 ​​일으키는 최적화 플러그인 수정

최적화 플러그인이 JavaScript를 최소화하거나 결합하는 과정에서 WooCommerce에 문제가 발생하는 경우 , 다음 스크립트를 플러그인의 제외 목록에 추가하세요.

축소에서 제외할 스크립트:

• woocommerce/assets/js/frontend/woocommerce.min.js

• woocommerce/assets/js/frontend/add-to-cart.min.js

• woocommerce/assets/js/frontend/add-to-cart-variation.min.js

• jquery.js 또는 jquery.min.js

또한, WooCommerce 페이지(장바구니(/cart/), 결제(/checkout/), 내 계정(/my-account/) 및 모든 제품 페이지(/product/))를 JavaScript 최적화에서 제외하세요.

WP Rocket에서: 파일 최적화 > JavaScript 파일로 이동합니다. 위의 제외 항목을 제외할 JavaScript 파일 필드에 추가합니다.

Autoptimize에서 JavaScript 옵션 > Autoptimize에서 스크립트 제외로 이동하여 WooCommerce 스크립트 경로를 추가하세요.

해결 방법 4: 제품 정보를 확인하고 입력하세요

WooCommerce는 필수 상품 정보가 누락된 경우 '장바구니에 담기' 버튼을 자동으로 비활성화합니다. 특정 상품에서만 버튼이 표시되고 다른 상품에서는 정상적으로 작동하는 경우, 여기에서부터 확인해 보세요.

필수 입력 항목으로 인해 버튼이 사라지는 경우

WooCommerce는 '장바구니에 담기' 버튼을 표시하기 위해 특정 제품 데이터가 필요합니다. 필수 입력란이 누락된 경우, WooCommerce는 오류 메시지 없이 버튼 표시를 자동으로 비활성화합니다.

버튼이 없는 모든 제품을 확인하세요:

• 가격: 모든 제품에는 정가가 설정되어 있어야 합니다. 가격이 설정되지 않은 제품에는 '장바구니에 담기' 버튼이 표시되지 않습니다. 제품 > 제품 데이터 > 일반으로 이동하여 '정가' 필드에 값이 입력되어 있는지 확인하십시오.

• 제품명: 제품에는 반드시 제목이 있어야 합니다. 제목은 거의 누락되지 않지만, 새로 작성하는 초안에서는 확인하는 것이 좋습니다.

• 표시 여부: 제품의 카탈로그 표시 여부가 '쇼핑 및 검색 결과' 또는 '쇼핑'으로 설정되어 있는지 확인하십시오. '숨김'으로 설정된 제품은 아카이브 페이지에 버튼이 표시되지 않습니다.

• 제품 상태: 제품이 게시되었는지, 초안 또는 검토 대기 중인지 확인하십시오.

장바구니 담기용 가변 제품 구성

가변 상품은 일반 상품과 다르게 동작합니다. 상점/아카이브 페이지에서 가변 상품은 '장바구니에 담기' 버튼 대신 '옵션 선택' 버튼을 표시합니다. 개별 상품 페이지에서는 고객이 필수 속성을 모두 선택한 후에만 '장바구니에 담기' 버튼이 나타납니다.

가변 상품 페이지에서 '장바구니에 담기' 버튼이 완전히 사라진 경우(쇼핑 페이지에서 '선택' 옵션만 표시되는 것이 아닌 경우), 다음 사항을 확인하세요

• 하나 이상의 제품 변형이 존재합니다(제품 데이터 > 변형 > 변형 추가)

• 적어도 한 가지 변형 상품은 재고가 있는 상태로 '재고 있음'으로 표시되어 있습니다

• 변형에 사용되는 모든 속성은 변형을 생성하기 전에 제품 데이터 > 속성에서 정의됩니다

• 옵션 탭에는 구성 오류가 표시되지 않습니다

옵션 변형이 생성되지 않았거나 모든 옵션 변형이 품절된 가변 상품에는 '장바구니에 담기' 버튼이 표시되지 않습니다.

재고 현황 및 품절 설정

WooCommerce > 설정 > 제품 > 재고로 이동하세요. '품절 상품 카탈로그에서 숨기기' 옵션이 활성화되어 있는지 확인하세요. 이 옵션이 활성화되어 있으면 품절로 표시된 제품은 상점 페이지에 나타나지 않으며 '장바구니에 담기' 버튼도 표시되지 않습니다.

또한, 개별 제품의 재고 상태를 확인하세요. 제품 > 제품 데이터 > 재고 > 재고 상태에서 '재고 있음'으로 설정되어 있는지 확인하십시오. 수동으로 '재고 없음'으로 설정된 제품은 카탈로그 설정과 관계없이 '장바구니에 담기' 버튼이 표시되지 않습니다.

해결 방법 5: WooCommerce 페이지 및 퍼머링크 설정을 확인하세요

장바구니 페이지 설정 오류나 오래된 퍼머링크 구조는 플러그인 디버깅으로도 해결할 수 없는 숨겨진 오류를 발생시킵니다. 다음 세 가지 점검은 5분도 채 걸리지 않으며, 대부분의 쇼핑몰 운영자가 예상하는 것보다 훨씬 더 많은 문제를 해결해 줍니다.

장바구니 및 결제 페이지 할당 확인

WooCommerce에서 장바구니 기능을 사용하려면 특정 페이지가 존재하고 올바르게 할당되어 있어야 합니다. 장바구니 페이지 또는 결제 페이지가 삭제되거나 게시가 취소되거나 잘못된 페이지로 재할당되면 '장바구니에 담기' 버튼 클릭이 오류 없이 실패하거나 잘못된 페이지로 리디렉션될 수 있습니다.

WooCommerce > 설정 > 고급 > 페이지 설정으로 이동합니다. 다음을 확인하세요

• 장바구니: [woocommerce_cart] 숏코드 또는 WooCommerce 장바구니 블록이 포함된 게시된 페이지에 할당됨

• Checkout: [woocommerce_checkout] 숏코드 또는 WooCommerce Checkout 블록이 포함된 게시된 페이지에 할당됩니다

• 내 계정: '내 계정' 블록 또는 단축 코드가 포함된 게시된 페이지에 할당됨

누락되었거나 잘못 할당된 항목이 있으면 다시 할당하십시오. 페이지 자체가 없는 경우, 올바른 단축 코드를 사용하여 새 페이지를 만들고 여기에 할당하십시오.

퍼머링크 구조를 새로 고치세요

WordPress는 요청을 올바르게 라우팅하기 위해 퍼머링크 규칙을 사용합니다. 이러한 규칙이 손상되면 다른 모든 설정이 올바르더라도 WooCommerce AJAX 요청이 실패할 수 있습니다. 퍼머링크 구조를 새로 고치면 이러한 규칙이 다시 생성됩니다.

WordPress 관리자 화면에서 설정 > 고유 링크로 이동합니다. 설정을 변경하지 마세요. 변경 사항 저장을 클릭합니다. 이렇게 하면 새로운 고유 링크 규칙이 포함된 .htaccess 파일이 다시 생성되어 장바구니 버튼 오류로 인해 발생하는 라우팅 문제가 해결됩니다.

이 작업은 10초도 채 걸리지 않으며 콘텐츠에 아무런 영향을 미치지 않습니다. 비용이 전혀 들지 않고 장바구니 오류의 상당수를 해결할 수 있으므로 문제 해결 과정 초기에 시도해 볼 가치가 있습니다.

WooCommerce 상태 페이지에서 오류를 확인하세요

WooCommerce > 상태로 이동하세요. 이 페이지에는 WooCommerce 설치에 대한 자세한 개요가 표시됩니다. 빨간색으로 강조 표시된 행은 구성 오류를 나타냅니다.

장바구니 담기 버튼에 영향을 미치는 상태 페이지에 표시되는 일반적인 오류는 다음과 같습니다

• 데이터베이스가 오래되었습니다: WooCommerce 데이터베이스 테이블을 업데이트해야 합니다. '데이터베이스 업데이트' 버튼을 클릭하세요.

• WooCommerce.js파일이 없거나 접근할 수 없습니다. 이로 인해 '장바구니에 담기' 버튼이 작동하지 않습니다.

• 템플릿 재정의: 테마에서 WooCommerce 템플릿 파일을 재정의했습니다. 재정의된 파일이 이전 WooCommerce 버전에서 가져온 것이라면 새로운 기능이 누락되었을 수 있습니다. 테마를 업데이트하거나 오래된 재정의 파일을 제거하세요.

해결 방법 6: 캐시를 지우세요

캐싱 플러그인이 제품 페이지의 오래된 버전을 제공하는 경우, 다른 모든 해결 방법을 적용한 후에도 '장바구니에 담기' 버튼이 응답하지 않는 문제가 발생할 수 있습니다. 따라서 문제 해결의 초기 단계로, 그리고 모든 변경 사항을 적용한 후 최종 단계로 항상 캐시를 삭제하십시오.

WP Rocket 캐시 지우기: 관리자 화면에서 WP Rocket 아이콘을 클릭한 다음 '캐시 지우기'를 선택하세요.

W3 Total Cache에서 캐시를 지우려면: 성능 > 모든 캐시 삭제를 선택하십시오.

WP Super Cache 캐시를 삭제하세요: 설정 > WP Super Cache > 캐시 삭제.

LiteSpeed ​​Cache에서 캐시를 지우려면 다음 단계를 따르세요: LiteSpeed ​​Cache > 모두 지우기.

Cloudflare 캐시 지우기: Cloudflare 대시보드 > 캐싱 > 구성 > 모두 삭제.

브라우저 캐시를 삭제하세요. Chrome 또는 Firefox에서는 Ctrl+Shift+Delete를 누르세요. 캐시된 이미지와 파일을 삭제하세요. 문제가 해결되었는지 확인하려면 개인 정보 보호 모드/시크릿 모드 창에서 제품 페이지를 새로고침하세요. 이렇게 하면 브라우저 캐시가 영향을 미치지 않습니다.

캐시를 모두 삭제한 후, 해당 제품 페이지에서 '장바구니에 담기' 버튼을 테스트해 보세요. 브라우저 캐시 문제인지 확인하기 위해 시크릿 모드 창에서도 테스트할 수 있습니다.

문제 해결 체크리스트: 올바른 순서

이 단계들을 순서대로 진행하세요. 버튼이 작동하면 멈추세요.

• 사이트 및 데이터베이스 전체 백업을 수행하십시오

• 오류 유형을 알려주세요 (표시되지 않음 / 클릭할 수 없음 / 클릭했지만 업데이트되지 않음)

• 브라우저 콘솔에서 JavaScript 오류를 확인하고 특정 오류를 기록해 두세요

• 설정 > 영구 링크로 이동하여 변경 사항 저장(설정 변경 필요 없음)을 클릭하세요

• WooCommerce > 상태에서 빨간색 오류가 있는지 확인하고 해결하세요

• 제품 데이터 확인: 가격 설정됨, 재고 상태: 재고 있음, 옵션 설정됨

• WordPress, WooCommerce, 모든 플러그인 및 테마를 업데이트하세요

• 모든 캐시를 지우세요: 캐싱 플러그인 + 클라우드플레어 + 브라우저

• WooCommerce를 제외한 모든 플러그인을 비활성화하고 테스트하세요

• 플러그인이 비활성화된 상태에서 버튼이 정상적으로 작동한다면, 플러그인을 하나씩 다시 활성화하여 충돌 여부를 확인하십시오

• 스토어프론트 테마로 전환하고 테스트해 보세요

• 스토어프론트에서 버튼이 정상적으로 작동한다면, 활성화된 테마가 원인일 가능성이 높습니다

• WooCommerce > 설정 > 고급 > 페이지 설정에서 장바구니 및 결제 페이지 할당을 확인하세요

• 최적화 플러그인의 제외 목록에 WooCommerce 스크립트를 추가하세요

WooCommerce 장바구니 버튼 문제 해결에 대한 최종 의견

WooCommerce 장바구니 담기 버튼 오류의 대부분은 플러그인 충돌, 캐싱 문제 또는 불완전한 제품 데이터로 인해 발생합니다. 이 세 가지 문제 모두 명확한 진단 경로와 구체적인 해결 방법이 있으며, 맞춤 개발이.

먼저 진단표를 참조하여 오류 유형을 파악하세요. 상태 페이지를 확인하고 퍼머링크를 초기화하는 것이 좋습니다. 이 작업은 비용이 들지 않으며 상당수의 문제를 해결해 줍니다. 다른 변경 사항을 적용하기 전에 모든 것을 업데이트하세요. 그런 다음 플러그인 및 테마 충돌 문제를 해결하십시오.

이 목록에 있는 모든 해결 방법을 적용했는데도 버튼이 여전히 작동하지 않는다면, 사용자 정의 코드 충돌이나 서버 수준 구성 문제일 가능성이 높습니다. 이 경우 WooCommerce 경험이 있는 WordPress 개발자가 브라우저 콘솔 오류, 서버 오류 로그 및 WooCommerce 디버그 로그를 함께 검토해야 합니다.

Seahawk의 WooCommerce 개발팀은 긴급 지원 및 지속적인 유지 보수 서비스의 일환으로 장바구니 담기 버튼 관련 문제를 해결합니다.

WooCommerce 장바구니 담기 버튼이 작동하지 않을 때 자주 묻는 질문