이는 일반적으로 최종 사용자가 체크박스를 클릭한 후 reCAPTCHA 위젯 HTML 요소가 프로그래매틱 방식으로 삭제되는 경우에 발생합니다.
reCAPTCHA 위젯을 재설정하려면 grecaptcha.enterprise.reset() JavaScript 함수를 사용하는 것이 좋습니다.
로컬 호스트가 지원되는 도메인 목록에 없습니다.
로컬 호스트 도메인은 기본적으로 지원되지 않습니다. 개발을 위해 계속 지원하려면 사이트 키의 지원되는 도메인 목록에 추가하면 됩니다.
Google Cloud 콘솔로 이동하여 지원되는 도메인 목록을 업데이트합니다. 개발 및 프로덕션에 별도의 키를 사용하고 개발 사이트 키에서 localhost만 허용하는 것이 좋습니다.
reCAPTCHA가 평가를 만들 때 BROWSER_ERROR를 반환했습니다.
BROWSER_ERROR 토큰은 reCAPTCHA 스크립트가 execute 작업을 실행할 수 없는 경우에 발생합니다. 대부분의 경우 클라이언트 측 네트워크 오류 또는 시간 초과로 인해 발생합니다. JavaScript를 사용하여 execute()를 다시 시도해야 합니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-04(UTC)"],[],[],null,["# Troubleshoot reCAPTCHA integration issues\n\n\u003cbr /\u003e\n\nThis document lists common reCAPTCHA integration issues that\ndevelopers might encounter when using reCAPTCHA in their environment.\n| **Note:** If you're an end user experiencing issues with reCAPTCHA visual challenges, ensure that your browser is up to date or try a different browser. If the problem persists, contact the website's support team.\n\nInvalid site key\n----------------\n\nIf you see the `Invalid site key` error, your reCAPTCHA\nsite key is no longer valid. [Create a new key](/recaptcha/docs/create-key-website)\nand [install it on your web pages](/recaptcha/docs/instrument-web-pages).\n\nKeys migration failure\n----------------------\n\nSite keys can fail to migrate in one of the following scenarios:\n\n- You've exceeded the number of projects that you\n or your organization can create.\n\n To resolve this, you can reuse an\n existing project, [request an increase in project creation quota](https://support.google.com/cloud/answer/7283050),\n or wait for the automated migration to complete.\n- Your workspace organization has restricted creating of new Google Cloud\n projects.\n\n To turn on the Google Cloud service in the Google Admin console,\n contact your administrator. For more information, see\n [Turn Google Cloud on or off for users](https://support.google.com/a/answer/182442).\n\nSecurityError: blocked a frame with origin \"https://www.google.com\" from accessing a frame with origin \"\\<your domain\\>\"\n----------------------------------------------------------------------------------------------------------------------------\n\nThis typically occurs if the reCAPTCHA widget HTML element is\nprogrammatically removed sometime after the end user clicks on the checkbox.\nWe recommend using the [grecaptcha.enterprise.reset()](/recaptcha/docs/api-ref-checkbox-keys#grecaptchaenterprisereset)\nJavaScript function to reset the reCAPTCHA widget.\n\nLocalhost is not in the list of supported domains\n-------------------------------------------------\n\nLocalhost domains are not supported by default. If you want to continue\nsupporting them for development, you can add them to the list of supported\ndomains for your site key.\nGo to the [Google Cloud console](https://console.cloud.google.com/security/recaptcha)\nto update your list of supported domains. We advise to use separate keys for\ndevelopment and production, and to only allow localhost on your development site\nkey.\n\nreCAPTCHA returned BROWSER_ERROR when creating an assessment\n------------------------------------------------------------\n\n`BROWSER_ERROR` tokens occur when the reCAPTCHA script cannot perform\nan `execute` operation. In most cases, this is due to a client-side network\nfailure or timeout. You must retry `execute()` using the JavaScript."]]
