reCAPTCHA 작동하지 않음: 모든 사용자를 위한 단계별 해결 방법

reCAPTCHA가 웹사이트나 브라우저에서 작동하지 않는 경우, 브라우저 문제, 네트워크 제한 또는 통합 오류가 원인일 수 있습니다. 이 가이드는 기본 브라우저 설정부터 고급 개발자 문제 해결까지 가장 일반적인 증상과 해결 방법을 안내합니다.

reCAPTCHA 작동하지 않는 문제 해결 방법
1. reCAPTCHA가 로드되지 않거나 계속 회전함
1. “reCAPTCHA 서비스에 연결할 수 없음”
1. “사이트 키의 잘못된 도메인”
1. “잘못된 사이트 키” 또는 “잘못된 키 유형”
1. reCAPTCHA가 항상 검증 실패
1. “귀하의 컴퓨터 또는 네트워크가 자동화된 쿼리를 전송하고 있을 수 있습니다”
자주 묻는 질문
결론

reCAPTCHA 작동하지 않는 문제 해결 방법

1. reCAPTCHA가 로드되지 않거나 계속 회전함

무슨 일이 벌어지고 있나요:

reCAPTCHA 박스가 나타나지 않거나 로딩 스피너만 보입니다.

사용자를 위한 해결 방법:

브라우저를 최신 버전으로 업데이트합니다 (Google은 주요 브라우저의 마지막 두 버전만 지원합니다).
브라우저 설정에서 JavaScript와 쿠키를 활성화합니다.
Ghostery 또는 uBlock과 같은 광고 차단기를 일시적으로 끄거나 Google 도메인을 허용 목록에 추가합니다.
브라우저 캐시를 삭제하거나 사이트를 인코그니토 모드에서 엽니다.
네트워크를 변경하거나 방화벽 뒤에 있거나 Google 도메인이 차단된 국가에서는 VPN을 사용합니다.
CAPTCHA를 올바르게 지원하는 브라우저를 확실히 모르겠다면, совместимость을 위한 reCAPTCHA의 전체 브라우저 지원 목록을 확인하세요.

개발자를 위한 해결 방법:

올바른 스크립트를 포함합니다:

또는 v3의 경우:

위젯이 렌더링되기 전에 숨겨진 요소나 모달 안에 있지 않도록 합니다.
숨겨진 위젯을 표시한 후 grecaptcha.reset()을 호출합니다.
콘텐츠 보안 정책을 업데이트하여 다음을 허용합니다:
https://www.google.com/recaptcha/
https://www.gstatic.com/recaptcha/
귀하의 지역에서 Google이 차단된 경우 https://www.recaptcha.net/recaptcha/api.js를 사용합니다.
로컬 테스트 시 “localhost”를 키의 허용 도메인에 추가합니다.

2. “reCAPTCHA 서비스에 연결할 수 없음”

무슨 일이 벌어지고 있나요:

연결 문제로 인해 reCAPTCHA를 로드할 수 없다는 오류 메시지가 표시됩니다.

사용자를 위한 해결 방법:

인터넷 연결을 확인하고 www.google.com에 접근할 수 있는지 확인합니다.
다른 네트워크로 변경합니다 (Wi-Fi 또는 셀룰러).
다른 브라우저나 장치를 시도합니다.
앱이나 임베디드 웹뷰에서 발생하는 경우, 앱이 DOM 저장소를 활성화하거나 허용 도메인을 업데이트해야 할 수 있습니다.

개발자를 위한 해결 방법:

브라우저 콘솔에서 BROWSER_ERROR 또는 기타 네트워크 오류를 검사합니다.
네트워크에 문제가 있을 경우 reCAPTCHA 실행을 재시도합니다.
Android WebView에서 DOM 저장소를 활성화합니다:

settings.setDomStorageEnabled(true);

HTTPS를 사용하여 혼합 콘텐츠 오류를 피합니다.
시스템 시간을 확인하세요—장치 시계가 잘못된 경우 SSL 인증이 실패합니다.
테스트할 때 Google의 관리 패널에서 localhost를 허용 목록에 추가합니다.

3. “사이트 키의 잘못된 도메인”

무슨 일이 벌어지고 있나요:

“사이트 소유자에 대한 오류: 사이트 키의 잘못된 도메인”이 표시됩니다.

개발자를 위한 해결 방법:

Google reCAPTCHA 관리 패널에 로그인합니다.
올바른 도메인 이름(예: example.com 및 www.example.com)을 추가합니다 — http://를 포함하지 마십시오.
체크박스/비가시용에는 v2 키를 사용하고 점수 기반 위젯에는 v3 키를 사용합니다. 서로 혼합하지 마세요.
필요한 경우, 새 키를 재생성하고 코드를 업데이트합니다.

사용자를 위한 해결 방법:

이 문제가 서드파티 사이트에서 발생하는 경우, 귀하의 잘못이 아닙니다. URL의 www 또는 비-www 버전에 접근해 보거나 사이트 지원팀에 문의하세요.

4. “잘못된 사이트 키” 또는 “잘못된 키 유형”

무슨 일이 벌어지고 있나요:

위젯이 고장 나거나 키 관련 오류가 발생하여 즉시 실패합니다.

개발자를 위한 해결 방법:

사이트 키가 위젯 버전과 일치하는지 확인합니다.
v2 키는 v2 위젯과만 작동합니다.
v3 키는 v3 API와만 작동합니다.
엔터프라이즈 키는 특별한 API 호출이 필요합니다.
사이트 키와 비밀 키를 혼동하지 마세요 — 각각 다른 위치(프론트엔드 vs 백엔드)에 필요합니다.
키가 비활성화되었거나 유형을 변경한 경우, 새 키를 생성하고 설정에 교체합니다.

사용자를 위한 해결 방법:

이는 개발자 측 문제입니다. 새로 고침을 시도할 수 있지만, 잘못된 키가 사용 중인 경우에는 사이트 소유자만이 해결할 수 있습니다.

5. reCAPTCHA가 항상 검증 실패

무슨 일이 벌어지고 있나요:

CAPTCHA를 완료했지만, 양식이 여전히 제출되지 않거나 검증 실패라고 합니다.

개발자를 위한 해결 방법:

서버 측 POST 요청을 다시 확인합니다:

https://www.google.com/recaptcha/api/siteverify

두 가지를 포함해야 합니다:
secret: 귀하의 비밀 키
response: 사용자의 g-recaptcha-response 토큰 (양식 필드)
요청을 문자열화하지 마세요. 표준 application/x-www-form-urlencoded 형식을 사용합니다.
reCAPTCHA v3를 사용하는 경우:
점수 임계값을 조정합니다. 일부 사용자는 낮은 점수(<0.5)를 받아 차단될 수 있습니다.
높은 점수와 함께 “무료 할당량 초과”가 표시되는 경우, 사용량이 한도를 초과했음을 의미합니다.

사용자를 위한 해결 방법:

오디오 대안을 사용하여 CAPTCHA를 해결해 보세요.
브라우저 캐시를 삭제하거나 다른 브라우저로 전환합니다.
문제가 계속되면 사이트의 지원 팀에 신고하세요.

6. “귀하의 컴퓨터 또는 네트워크가 자동화된 쿼리를 전송하고 있을 수 있습니다”

무슨 일이 벌어지고 있나요:

Google이 귀하의 연결을 의심스럽다고 표시합니다.

사용자를 위한 해결 방법:

다른 네트워크로 변경하거나 VPN/프록시에서 연결을 끊습니다.
몇 시간 기다리세요 — 속도 제한은 일반적으로 임시입니다.
요청 시, 인간임을 증명하기 위해 CAPTCHA 도전을 진행하세요.

개발자를 위한 해결 방법:

CAPTCHA를 반복적으로 로드하는 루프가 발생하고 있는지 확인하세요.
여러 사용자가 이 문제를 보고하는 경우, IP를 변경하도록 제안하거나 귀하의 도메인이 Google에 의해 표시되고 있는지 조사하세요.

자주 묻는 질문

왜 내 브라우저에 reCAPTCHA가 표시되지 않나요? 광고 차단기, 구식 브라우저, JavaScript 비활성화 또는 네트워크 제한 때문일 수 있습니다. “잘못된 사이트 키” 오류를 어떻게 해결하나요? 네. 키를 생성 또는 편집할 때 Google reCAPTCHA 관리 패널에서 localhost를 허용 목록에 추가하세요. v2와 v3 reCAPTCHA의 차이점은 무엇인가요? v2는 체크박스나 도전을 보여줍니다. v3는 자동으로 상호작용을 점수화하며 사용자 상호작용이 필요하지 않습니다. 인코그니토 모드에서 reCAPTCHA가 작동하나요? 예, 그러나 인코그니토 모드에서 광고 차단기나 더 높은 개인 정보 보호 설정이 스크립트 로딩을 방해할 수 있습니다.

결론

reCAPTCHA가 작동하지 않을 때, 문제는 종종 브라우저 설정, 네트워크 제한 또는 잘못 구성된 사이트 키에 있습니다. 사용자에게는 확장 기능을 비활성화하거나 브라우저를 업데이트하는 것만으로도 해결될 수 있습니다. 개발자의 경우 통합 세부정보, 도메인 설정 및 API 버전을 검토하는 것이 중요합니다. 오류가 지속되면 Google의 지원 문서와 관리 콘솔이 최종 해결 도구를 제공합니다.