Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
In diesem Dokument werden häufige Probleme bei der reCAPTCHA-Integration aufgeführt, die bei der Verwendung von reCAPTCHA in der jeweiligen Umgebung auftreten können.
SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "<your domain>"
Dies tritt in der Regel auf, wenn das HTML-Element des reCAPTCHA-Widgets programmatisch entfernt wird, nachdem der Endnutzer auf das Kästchen geklickt hat.
Wir empfehlen, das reCAPTCHA-Widget mit der JavaScript-Funktion grecaptcha.enterprise.reset() zurückzusetzen.
Localhost befindet sich nicht in der Liste der unterstützten Domains.
Localhost-Domains werden standardmäßig nicht unterstützt. Wenn Sie sie weiterhin für die Entwicklung unterstützen möchten, können Sie sie der Liste der unterstützten Domains für Ihren Websiteschlüssel hinzufügen.
Rufen Sie die Google Cloud -Konsole auf, um die Liste der unterstützten Domains zu aktualisieren. Wir empfehlen, separate Schlüssel für die Entwicklung und die Produktion zu verwenden und nur localhost für den Schlüssel Ihrer Entwicklungswebsite zuzulassen.
reCAPTCHA hat beim Erstellen einer Bewertung BROWSER_ERROR zurückgegeben
BROWSER_ERROR-Tokens werden ausgegeben, wenn das reCAPTCHA-Script keine execute-Operation ausführen kann. In den meisten Fällen ist dies auf einen clientseitigen Netzwerkfehler oder eine Zeitüberschreitung zurückzuführen. Sie müssen execute() mit dem JavaScript noch einmal versuchen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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."]]
