Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este documento, se enumeran los problemas comunes de integración de reCAPTCHA que los desarrolladores pueden encontrar cuando usan reCAPTCHA en su entorno.
SecurityError: Se bloqueó el acceso de un iframe con el origen "https://www.google.com" a un iframe con el origen "<your domain>"
Por lo general, esto ocurre si el elemento HTML del widget de reCAPTCHA se quita de forma programática en algún momento después de que el usuario final hace clic en la casilla de verificación.
Te recomendamos que uses la función de JavaScript grecaptcha.enterprise.reset() para restablecer el widget de reCAPTCHA.
Localhost no está en la lista de dominios admitidos
Los dominios de localhost no son compatibles de forma predeterminada. Si quieres seguir admitiéndolos para el desarrollo, puedes agregarlos a la lista de dominios admitidos para tu clave del sitio.
Ve a la consola deGoogle Cloud para actualizar tu lista de dominios admitidos. Te recomendamos que uses claves separadas para el desarrollo y la producción, y que solo permitas localhost en la clave de tu sitio de desarrollo.
reCAPTCHA devolvió BROWSER_ERROR cuando se creó una evaluación
Los tokens BROWSER_ERROR se producen cuando la secuencia de comandos de reCAPTCHA no puede realizar una operación execute. En la mayoría de los casos, esto se debe a un error o tiempo de espera de la red del cliente. Debes volver a intentar execute() con JavaScript.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
