3 minutes November 20, 2026

So beheben Sie Probleme mit Google reCAPTCHA v3 in benutzerdefinierten AJAX-Formularen in Shopware

Benutzerdefinierte AJAX-Formulare verwendenFormCmsHandlerDie Google reCAPTCHA v3-Validierung im Live-Shopware-Shop kann fehlschlagen, selbst wenn die reCAPTCHA-Schlüssel und die serverseitige Verifizierung korrekt konfiguriert sind.

Bei der Überprüfung der Netzwerkanfrage,_grecaptcha_v3Das Feld kann den Wert enthaltenreCAPTCHA ausstehendanstelle eines gültigen Google reCAPTCHA-Tokens.

Infolgedessen hat GoogleWebsite überprüfenDer Endpunkt lehnt die Anfrage ab, und das Formular kann nicht übermittelt werden.

Ursache

Das Google reCAPTCHA-Plugin von Shopware generiert das Token asynchron. Benutzerdefinierte Formular-Plugins, die dies implementieren, verwenden hingegensendAjaxFormSubmit()Das Formular kann vor Abschluss der Token-Generierung eingereicht werden.

Die reCAPTCHA-Integration von Shopware verwendet dieformSubmittedByCaptchaDieses Flag dient der Verwaltung von Formularübermittlungen. Es erwartet, dass das benutzerdefinierte Formular-Plugin die AJAX-Übermittlung verzögert, damit das reCAPTCHA-Plugin das Formular übernehmen und absenden kann, sobald ein gültiges Token verfügbar ist.

Wenn das benutzerdefinierte Formular zu früh abgeschickt wird, enthält die Anfrage den Platzhalterwert.reCAPTCHA ausstehendanstelle des eigentlichen Google reCAPTCHA-Tokens.

Lösung

Aktualisieren Sie das benutzerdefinierte Formular-Plugin, sodass es dem reCAPTCHA-Übermittlungsablauf von Shopware folgt. Dadurch wird verhindert, dass das Formular vor dem Vorliegen des CAPTCHA-Tokens abgeschickt wird.

Nehmen Sie die folgenden Änderungen vor:

1. Initialisieren Sie das reCAPTCHA-Übermittlungsflag.

Satz this.formSubmittedByCaptcha = falseinnerhalb des PluginsHitze()Methode. Das reCAPTCHA-Plugin von Shopware verwendet dieses Flag, um den Übermittlungsprozess zu steuern.

2. Die erste AJAX-Übermittlung verzögern.

In _submitForm(), Anruf sendAjaxFormSubmit()nur wennthis.formSubmittedByCaptchaist falsch.

Dies ermöglicht ShopwareGoogleReCaptchaBasePluginden Einreichungsprozess übernehmen und anrufensendAjaxFormSubmit()nach der Token-Generierung.

3. Überprüfen Sie das CAPTCHA-Token vor dem Absenden.

Bevor Sie die AJAX-Anfrage ausführen, überprüfen Sie Folgendes:_grecaptcha_v3 oder _grecaptcha_v2Eingabefeld.

Wenn das Feld leer ist oder noch enthältreCAPTCHA ausstehend, die Übermittlung abbrechen, anstatt eine ungültige Anfrage zu senden.

Beispielcode

Aktualisieren Sie das benutzerdefinierte Formular-Plugin wie folgt:

4. Wenden Sie die Korrektur auf Designüberschreibungen an.

Wenn Ihr Shopware-Shopfront ein Theme-Override verwendetFormCmsHandlerWenden Sie dort dasselbe Muster für die Bearbeitung von Einreichungen an.

Beispielsweise benutzerdefinierte Designimplementierungen wieHeinz-Themasollte ebenfalls überprüft und aktualisiert werden, um zu verhindern, dass das gleiche Problem erneut auftritt.

5. Erstellen Sie das Storefront-JavaScript neu.

Nach der Durchführung der Änderungen:

  1. Das JavaScript der Shopware-Shopfront muss neu erstellt werden.
  2. Leeren Sie die entsprechenden Storefront-Caches.
  3. Testen Sie das benutzerdefinierte Formular in der Testumgebung oder im Live-Shop.
  4. Überprüfen Sie die Netzwerkanfrage und vergewissern Sie sich, dass_grecaptcha_v3enthält ein gültiges Token anstelle vonreCAPTCHA ausstehendDie
  5. Bestätigen Sie, dass die AJAX-Formularübermittlung erfolgreich abgeschlossen wurde.

Abschluss: Erwartetes Ergebnis

Das benutzerdefinierte AJAX-Formular wartet, bis die reCAPTCHA-Integration von Shopware ein gültiges Token generiert hat, bevor die Anfrage gesendet wird.

Dadurch werden vorzeitige Formularübermittlungen verhindert und die Google reCAPTCHA-Validierung kann erfolgreich abgeschlossen werden.

Grüße! Ich bin Aneesh Sreedharan, CEO von 2Hats Logic Solutions. Bei 2Hats Logic Solutions widmen wir uns der Bereitstellung von technischem Fachwissen und der Lösung Ihrer Probleme in der Welt der Technologie. Unsere Blog-Seite dient als Ressource, in der wir Einblicke und Erfahrungen teilen und wertvolle Perspektiven auf Ihre Fragen bieten.
CEO
Aneesh Sreedharan
Gründer & CEO, 2Hats Logic Solutions
Abonnieren Sie unseren Newsletter
Aneesh ceo

    Bleiben Sie auf dem Laufenden!

    Abonnieren Sie unseren Newsletter und erfahren Sie mehr über die neuesten digitalen Trends.