reCAPTCHA Non Funziona: Risoluzioni Passo-Passo per Ogni Utente

Se reCAPTCHA non funziona sul tuo sito web o browser, è probabile che sia dovuto a problemi del browser, restrizioni di rete o errori di integrazione. Questa guida ti guida attraverso i sintomi e le risoluzioni più comuni, dalle impostazioni di base del browser al troubleshooting avanzato per sviluppatori.

Indice dei contenuti

• Come Risolvere reCAPTCHA Non Funzionante
• 1. reCAPTCHA Non Si Carica o Continua a Caricare
• 2. “Impossibile Connettersi al Servizio reCAPTCHA”
• 3. “Dominio Non Valido per la Chiave del Sito”
• 4. “Chiave del Sito Non Valida” o “Tipo di Chiave Non Valido”
• 5. reCAPTCHA Fallisce Sempre la Verifica
• 6. “Il Tuo Computer o Rete Potrebbero Inviare Query Automatiche”
• Domande Frequenti
• Conclusione

Come Risolvere reCAPTCHA Non Funzionante

1. reCAPTCHA Non Si Carica o Continua a Caricare

Cosa Sta Succedendo:

La casella reCAPTCHA non appare, oppure vedi solo una rotella di caricamento.

Risoluzione per gli Utenti:

• Aggiorna il tuo browser all’ultima versione (Google supporta solo le ultime due versioni dei principali browser).
• Abilita JavaScript e cookie nelle impostazioni del browser.
• Disattiva temporaneamente i blocchi pubblicitari come Ghostery o uBlock o aggiungi ai domini autorizzati i domini di Google.
• Svuota la cache del browser o apri il sito in modalità Incognito.
• Cambia rete o utilizza una VPN se ti trovi dietro un firewall o in un paese dove i domini di Google sono bloccati.
• Se non sei sicuro di quali browser supportano correttamente CAPTCHA, controlla questa lista completa di supporto per il reCAPTCHA per garantire la compatibilità.

Risoluzione per gli Sviluppatori:

• Includi lo script corretto:

<script src=”https://www.google.com/recaptcha/api.js” async defer></script>

o per v3:

<script src=”https://www.google.com/recaptcha/api.js?render=YOUR_SITE_KEY”></script>

• Assicurati che il widget non si trovi all’interno di elementi o modali nascosti prima del rendering.

• Chiama grecaptcha.reset() dopo aver mostrato un widget nascosto.

• Aggiorna le Politiche di Sicurezza dei Contenuti per consentire:

• https://www.google.com/recaptcha/

• https://www.gstatic.com/recaptcha/

• Usa https://www.recaptcha.net/recaptcha/api.js se Google è bloccato nella tua regione.

• Aggiungi “localhost” ai domini consentiti della tua chiave quando testi localmente.

2. “Impossibile Connettersi al Servizio reCAPTCHA”

Cosa Sta Succedendo:

Ricevi un messaggio di errore che dice che reCAPTCHA non è riuscito a caricare a causa di problemi di connessione.

Risoluzione per gli Utenti:

• Controlla la tua connessione internet e conferma che www.google.com sia raggiungibile.
• Cambia rete (Wi-Fi o cellulare).
• Prova un altro browser o dispositivo.
• Se sei in un’app o in un webview incorporato, l’app potrebbe dover abilitare lo storage DOM o aggiornare i domini autorizzati.

Risoluzione per gli Sviluppatori:

• Controlla la console del browser per BROWSER_ERROR o altri errori di rete.
• Ripeti l’esecuzione di reCAPTCHA se la rete fallisce.
• Nella WebView di Android, abilita lo storage DOM:

settings.setDomStorageEnabled(true);

• Evita errori di contenuto misto utilizzando HTTPS ovunque.
• Controlla l’ora di sistema: la verifica SSL fallisce se l’orologio del dispositivo è errato.
• Aggiungi localhost nella console di amministrazione di Google quando testi.

3. “Dominio Non Valido per la Chiave del Sito”

Cosa Sta Succedendo:

Vedi: ERRORE per il proprietario del sito: dominio non valido per la chiave del sito.

Risoluzione per gli Sviluppatori:

• Accedi alla console di amministrazione di Google reCAPTCHA.
• Aggiungi i nomi di dominio corretti (ad es., example.com e www.example.com) — non includere http://.
• Usa una chiave v2 per checkbox/invisibile, e una chiave v3 per widget basati sul punteggio. Non mescolare.
• Se necessario, rigenera una nuova chiave e aggiornala nel tuo codice.

Risoluzione per gli Utenti:

• Se questo succede su un sito di terze parti, non è colpa tua. Puoi provare ad accedere alla versione www o non-www dell’URL o contattare il supporto del sito.

4. “Chiave del Sito Non Valida” o “Tipo di Chiave Non Valido”

Cosa Sta Succedendo:

Il widget appare rotto o fallisce immediatamente con errori legati alla chiave.

Risoluzione per gli Sviluppatori:

• Assicurati che la chiave del sito corrisponda alla versione del widget.

• Le chiavi v2 funzionano solo con widget v2.

• Le chiavi v3 funzionano solo con API v3.

• Le chiavi Enterprise richiedono chiamate API speciali.

• Non confondere chiave del sito con chiave segreta — ciascuna va in un posto diverso (frontend vs backend).

• Se la tua chiave è stata disattivata o hai cambiato tipo, genera una nuova chiave e sostituiscila nella tua configurazione.

Risoluzione per gli Utenti:

• Questo è un problema lato sviluppatore. Puoi provare a ricaricare, ma se viene utilizzata la chiave sbagliata, può essere risolto solo dal proprietario del sito.

5. reCAPTCHA Fallisce Sempre la Verifica

Cosa Sta Succedendo:

Completi il CAPTCHA, ma il modulo non viene comunque inviato, o dice che la verifica è fallita.

Risoluzione per gli Sviluppatori:

• Controlla con attenzione la tua richiesta POST lato server a:

https://www.google.com/recaptcha/api/siteverify

• Includi entrambi:

• secret: la tua chiave segreta

• response: il token g-recaptcha-response dell’utente (campo del modulo)

• Non stringificare la richiesta. Usa il formato standard application/x-www-form-urlencoded.

• Se utilizzi reCAPTCHA v3:

• Regola la tua soglia di punteggio. Alcuni utenti potrebbero ricevere un punteggio basso (<0.5) e venire bloccati.

• Se vedi “Sopra il limite gratuito” con punteggi alti, significa che l’uso ha superato i limiti.

Risoluzione per gli Utenti:

• Prova a risolvere il CAPTCHA utilizzando l’alternativa audio.
• Svuota la cache del tuo browser o cambia browser.
• Se il problema persiste, riportalo al team di supporto del sito.

6. “Il Tuo Computer o Rete Potrebbero Inviare Query Automatiche”

Cosa Sta Succedendo:

Google segnala la tua connessione come sospetta.

Risoluzione per gli Utenti:

• Cambia rete o disconnetti da VPN/proxy.
• Aspetta qualche ora: i limiti di frequenza sono generalmente temporanei.
• Se richiesto, completa le sfide CAPTCHA per dimostrare di essere umano.

Risoluzione per gli Sviluppatori:

• Controlla se stai attivando loop che caricano ripetutamente CAPTCHA.
• Se molti utenti segnalano questo, suggerisci di cambiare IP o indaga se il tuo dominio è stato segnalato da Google.

Domande Frequenti

Perché reCAPTCHA non viene visualizzato nel mio browser? Potrebbe essere dovuto a blocchi pubblicitari, browser obsoleto, JavaScript disabilitato o restrizioni di rete. Come risolvere l’errore “Chiave del sito non valida”? Sì. Basta aggiungere localhost alla console di amministrazione di Google reCAPTCHA quando crei o modifichi la tua chiave. Qual è la differenza tra reCAPTCHA v2 e v3? v2 mostra una casella di controllo o una sfida. v3 valuta l’interazione in background e non richiede interazione da parte dell’utente. reCAPTCHA funziona in modalità incognito? Sì, ma i blocchi pubblicitari o le impostazioni di privacy più severe in incognito possono interferire con il caricamento degli script.

Conclusione

Quando reCAPTCHA non funziona, il problema spesso risiede nelle impostazioni del browser, nelle restrizioni di rete o nelle chiavi di sito configurate in modo errato. Per gli utenti, la soluzione può essere semplice come disabilitare le estensioni o aggiornare il browser. Per gli sviluppatori, rivedere i dettagli di integrazione, le impostazioni di dominio e le versioni API è fondamentale. Se gli errori persistono, la documentazione di supporto di Google e la console di amministrazione offrono gli strumenti finali per la risoluzione.