Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questo documento elenca i problemi comuni di integrazione di reCAPTCHA che
gli sviluppatori potrebbero riscontrare quando utilizzano reCAPTCHA nel loro ambiente.
SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "<your domain>"
In genere, questo si verifica se l'elemento HTML del widget reCAPTCHA viene rimosso a livello di programmazione qualche tempo dopo che l'utente finale ha fatto clic sulla casella di controllo.
Ti consigliamo di utilizzare la funzione JavaScript grecaptcha.enterprise.reset() per reimpostare il widget reCAPTCHA.
Localhost non è incluso nell'elenco dei domini supportati
I domini localhost non sono supportati per impostazione predefinita. Se vuoi continuare
a supportarli per lo sviluppo, puoi aggiungerli all'elenco dei domini
supportati per la chiave del sito.
Vai alla console
Google Cloud per aggiornare l'elenco dei domini supportati. Ti consigliamo di utilizzare chiavi separate per
lo sviluppo e la produzione e di consentire solo localhost nella chiave
del sito di sviluppo.
reCAPTCHA ha restituito BROWSER_ERROR durante la creazione di una valutazione
I token BROWSER_ERROR si verificano quando lo script reCAPTCHA non può eseguire
un'operazione execute. Nella maggior parte dei casi, questo problema è dovuto a un errore o a un timeout della rete lato client. Devi riprovare execute() utilizzando JavaScript.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 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."]]
