Comment résoudre le problème de reCAPTCHA : des solutions étape par étape pour chaque utilisateur

Gérer les bugs de reCAPTCHA peut être un vrai casse-tête, surtout lorsqu’ils sont tenaces et ne se chargent pas ou tournent sans cesse. C’est un peu étrange, mais parfois, il s’agit d’un problème de navigateur, de bloqueurs de publicités ou même de restrictions réseau. D’autres fois, pour les développeurs, il s’agit de mauvaises configurations ou de scripts obsolètes. Ce résumé tente de couvrir les deux aspects, que vous essayiez simplement de vous connecter ou de dépanner un site sur lequel vous travaillez. Les correctifs peuvent être étonnamment simples, mais en déterminer la cause relève parfois du jeu des devinettes.

Comment réparer le problème de reCAPTCHA qui ne fonctionne pas

reCAPTCHA ne se charge pas ou continue de tourner

Ce qui se passe:

La case à cocher ou la case de défi refuse tout simplement d’apparaître, ou le chargement se fait en boucle. Dans certaines configurations, le script semble bloqué en attente d’une réponse, ce qui peut être frustrant si vous êtes pressé.

Correction pour les utilisateurs :

• Mettez à jour votre navigateur avec la dernière version. Google prend principalement en charge les deux dernières versions majeures de Chrome, Firefox, Edge, etc. Par conséquent, si vous utilisez une version ancienne, le fonctionnement risque de ne pas être optimal.
• Activez JavaScript et les cookies dans vos paramètres. Cela peut être un problème fréquent, surtout si vous les avez désactivés pour des raisons de confidentialité ou de sécurité.
• Désactivez temporairement les bloqueurs de publicités comme Ghostery ou uBlock Origin, ou ajoutez les domaines Google ( www.google.com, apis.google.com, gstatic.com ) à votre liste blanche. Car bien sûr, les bloqueurs de publicités adorent interférer.
• Videz le cache de votre navigateur ou essayez d’ouvrir le site en mode navigation privée. Il arrive que des scripts ou des cookies en cache perturbent le fonctionnement du site.
• Changez de réseau ou utilisez un VPN si vous êtes sur un réseau restrictif ou dans un pays où les domaines Google sont bloqués ou fortement filtrés. Cela semblait évident, mais bon, ça vaut la peine d’être mentionné.
• Vérifiez quels navigateurs sont pris en charge par CAPTCHA pour vous assurer que le vôtre ne manque pas de compatibilité essentielle : recherchez simplement « navigateurs pris en charge par reCAPTCHA » sur Google et vous trouverez la liste.

Correction pour les développeurs :

• Assurez-vous d’avoir inclus la <script src="https://www.google.com/recaptcha/api.js" async defer></script>version v2 ou v3 avec le paramètre de rendu, comme <script src="https://www.google.com/recaptcha/api.js?render=YOUR_SITE_KEY"></script>. Car rien n’est plus frustrant qu’une URL manquante ou erronée.
• Assurez-vous que votre widget n’est pas masqué dans un modal ou un display: none div *avant* le rendu — reCAPTCHA doit être visible pour s’initialiser correctement.
• Si votre captcha est initialement masqué, appelez- grecaptcha.reset()le dès qu’il devient visible. Sinon, il risque de ne jamais se charger correctement.
• Vérifiez les en-têtes de votre politique de sécurité du contenu (CSP), surtout si vous déployez avec des CSP strictes. Assurez-vous que les autorisations incluent :
  • https://www.google.com/recaptcha/
  • https://www.gstatic.com/recaptcha/
• Si Google est bloqué par région, envisagez plutôt de passer à https://www.recaptcha.net/recaptcha/api.js.
• Pour les tests locaux, ajoutez localhost et votre nom d’hôte de développement à la liste des domaines autorisés dans la console d’administration Google reCAPTCHA.

2.« Impossible de se connecter au service reCAPTCHA »

Ce qui se passe:

C’est clair : vous obtenez une erreur indiquant que le chargement de reCAPTCHA a échoué, car la connexion a été impossible. Généralement, un blocage réseau ou de pare-feu, ou simplement une connexion Internet instable.

Correction pour les utilisateurs :

• Vérifiez votre connexion Internet. Ouvrez Google pour voir si l’application se charge. Si ce n’est pas le cas, le problème pourrait provenir de tout votre réseau.
• Passez à un autre réseau, peut-être Wi-Fi si vous êtes connecté par câble ou données mobiles si vous utilisez un Wi-Fi avec des restrictions folles.
• Essayez un autre navigateur ou appareil : parfois, certains navigateurs bloquent les scripts de manière plus agressive.
• Si vous utilisez une application ou une vue web intégrée, assurez-vous qu’elle autorise le stockage DOM et les scripts en ligne. Certaines applications les désactivent par défaut, ce qui perturbe le CAPTCHA.

Correction pour les développeurs :

• Vérifiez la console de votre navigateur pour détecter des erreurs telles que BROWSER_ERROR ou des pannes de réseau.
• Réessayez l’exécution de reCAPTCHA si le réseau rencontre un problème. Il s’agit parfois d’un simple accident.
• Pour Android WebView, assurez-vous que le stockage DOM est activé avec settings.setDomStorageEnabled(true);.
• Évitez les erreurs de contenu mixte. Assurez-vous que votre site utilise HTTPS partout ; le chargement de scripts via HTTP est bloqué.
• Vérifiez que l’horloge système est correcte. Des erreurs de certificat SSL peuvent survenir si la date et l’heure sont très erronées.
• Testez localement avec un domaine « localhost » ajouté à la liste blanche de votre console d’administration Google pour la validation de la clé de site.

3.« Domaine non valide pour la clé du site »

Ce qui se passe:

Généralement, un message du type : ERREUR pour le propriétaire du site : Domaine non valide pour la clé du site s’affiche. En d’autres termes, votre clé ne correspond pas à l’endroit où elle est utilisée.

Correction pour les développeurs :

• Connectez-vous à la console d’administration Google reCAPTCHA.
• Ajoutez le(s) domaine(s) exact(s) que vous hébergez, par exemple example.com ou subdomain.example.com.Évitez http:// ou https:// ; utilisez simplement le nom de domaine.
• Utilisez la version correcte de la clé : v2 pour case à cocher/invisible et v3 pour score. Ne mélangez pas les clés et n’utilisez pas la mauvaise version.
• Si cela ne fonctionne toujours pas, générez une nouvelle clé, puis mettez-la à jour dans le code de votre site. Il est étonnamment fréquent qu’une clé soit révoquée ou expire.

Correction pour les utilisateurs :

• Si vous consultez un site et que vous constatez cette erreur, elle provient probablement du développeur. Vous pouvez essayer d’accéder à la version www ou non-www de l’URL ; parfois, la non-concordance de domaine concerne uniquement le protocole ou le sous-domaine.
• Sinon, attendez et informez l’administrateur du site. C’est une solution de développeur.

4.« Clé de site non valide » ou « Type de clé non valide »

Ce qui se passe:

Le CAPTCHA peut apparaître cassé ou être rejeté immédiatement, avec des erreurs sur le type de clé ou une clé non valide.

Correction pour les développeurs :

• Vérifiez que la clé du site correspond à la version du widget :
  • Les touches v2 ne fonctionnent qu’avec les widgets v2 (case à cocher, invisible)
  • Les clés v3 sont destinées aux API basées sur les scores et ne fonctionneront pas avec les formulaires v2
  • Vous utilisez une clé d’entreprise ? Assurez-vous que les appels d’API sont correctement configurés.
• Assurez-vous de ne pas confondre votre clé de site avec votre clé secrète. Les clés secrètes servent uniquement à la vérification côté serveur, et non dans votre code frontend.
• Si vous avez généré une nouvelle clé ou changé de type de clé, pensez à mettre à jour votre site avec la nouvelle. Parfois, des clés anciennes ou désactivées peuvent simplement entraîner des erreurs.

Correction pour les utilisateurs :

• Ce problème est généralement du ressort du développeur ; si vous rencontrez cette erreur, vous ne pouvez pas faire grand-chose, à part patienter ou actualiser. La solution est du ressort du propriétaire du site.

5.reCAPTCHA échoue toujours à la vérification

Ce qui se passe:

Vous complétez le CAPTCHA, mais le formulaire refuse de s’envoyer ou affiche un message indiquant que la vérification a échoué. C’est assez agaçant, car on a l’impression que le CAPTCHA fonctionne, mais le serveur refuse de l’accepter.

Correction pour les développeurs :

• Vérifiez la requête POST de votre serveur sur https://www.google.com/recaptcha/api/siteverify. Assurez-vous qu’elle inclut les paramètres « secret » et « response » corrects.
• Envoyez les données sous forme d’application/x-www-form-urlencoded — ne les convertissez pas en chaîne JSON, sauf si vous gérez cela côté serveur.
• Si vous utilisez reCAPTCHA v3, vérifiez votre seuil de score : le système bloque parfois les utilisateurs ayant un score faible. Ajustez-le si nécessaire.
• Inspectez les journaux du serveur : la clé secrète est peut-être erronée, a expiré ou l’appel de vérification est bloqué par un pare-feu.

Correction pour les utilisateurs :

• Essayez de résoudre à nouveau le CAPTCHA, passez peut-être au défi audio si les images sont trop difficiles.
• Videz votre cache ou essayez un autre navigateur : parfois, les cookies ou les scripts stockés provoquent des problèmes.
• Signalez les problèmes au support du site si la vérification échoue toujours même après plusieurs tentatives.

6.« Votre ordinateur ou votre réseau envoie peut-être des requêtes automatisées »

Ce qui se passe:

Cet avertissement apparaît si Google pense que votre réseau est suspect ou automatisé, ce qui est assez ennuyeux, surtout si votre IP a été signalée pour une raison quelconque.

Correction pour les utilisateurs :

• Passez à un autre réseau : déconnectez peut-être les VPN ou les proxys, puis réessayez.
• Attendez quelques heures ou une journée, car Google lève généralement la limitation de débit temporaire.
• Si vous y êtes invité, répondez aux défis CAPTCHA pour montrer que vous êtes humain, surtout si vous êtes sur une adresse IP partagée ou dynamique.

Correction pour les développeurs :

• Assurez-vous que votre code ne déclenche pas de boucles qui continuent à charger ou à réexécuter le CAPTCHA à plusieurs reprises.
• Si de nombreux utilisateurs constatent ce problème, envisagez de mettre en œuvre des temps de recharge ou des limiteurs de débit, et conseillez-leur de changer d’adresse IP ou de désactiver temporairement les proxys.

FAQ