reCAPTCHA no funciona: soluciones paso a paso para cada usuario

Si reCAPTCHA no está funcionando en tu sitio web o navegador, probablemente se deba a problemas del navegador, restricciones de red o errores de integración. Esta guía te lleva a través de los síntomas y soluciones más comunes, desde la configuración básica del navegador hasta la solución de problemas avanzado para desarrolladores.

Tabla de contenidos

• Cómo solucionar que reCAPTCHA no funcione
• 1. reCAPTCHA no carga o sigue girando
• 2. “No se pudo conectar al servicio reCAPTCHA”
• 3. “Dominio no válido para la clave del sitio”
• 4. “Clave del sitio no válida” o “Tipo de clave no válido”
• 5. reCAPTCHA siempre falla la verificación
• 6. “Tu computadora o red pueden estar enviando consultas automatizadas”
• Preguntas frecuentes
• Conclusión

Cómo solucionar que reCAPTCHA no funcione

1. reCAPTCHA no carga o sigue girando

Qué está sucediendo:

La caja de reCAPTCHA no aparece, o solo ves un spinner de carga.

Solución para usuarios:

• Actualiza tu navegador a la última versión (Google solo admite las dos últimas versiones de los principales navegadores).
• Habilita JavaScript y cookies en la configuración del navegador.
• Desactiva los bloqueadores de anuncios como Ghostery o uBlock temporalmente o agrega los dominios de Google a la lista blanca.
• Borra la caché del navegador o abre el sitio en modo incógnito.
• Cambia de red o usa una VPN si estás detrás de un cortafuegos o en un país donde los dominios de Google están bloqueados.
• Si no estás seguro de qué navegadores admiten CAPTCHA correctamente, consulta esta lista completa de compatibilidad del navegador para reCAPTCHA para asegurar compatibilidad.

Solución para desarrolladores:

• Incluye el script correcto:

o para v3:

• Asegúrate de que el widget no esté dentro de elementos ocultos o modales antes de generar.

• Llama a grecaptcha.reset() después de mostrar un widget oculto.

• Actualiza la Política de Seguridad de Contenido para permitir:

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

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

• Usa https://www.recaptcha.net/recaptcha/api.js si Google está bloqueado en tu región.

• Agrega “localhost” a los dominios permitidos de tu clave al probar localmente.

2. “No se pudo conectar al servicio reCAPTCHA”

Qué está sucediendo:

Recibes un mensaje de error que dice que reCAPTCHA no pudo cargarse debido a problemas de conexión.

Solución para usuarios:

• Verifica tu conexión a internet y confirma que www.google.com sea accesible.
• Cambia a otra red (Wi-Fi o celular).
• Prueba otro navegador o dispositivo.
• Si estás en una app o vista web incrustada, la app puede necesitar habilitar el almacenamiento DOM o actualizar los dominios permitidos.

Solución para desarrolladores:

• Inspecciona la consola del navegador en busca de BROWSER_ERROR u otros errores de red.
• Intenta ejecutar reCAPTCHA nuevamente si la red falla.
• En Android WebView, habilita el almacenamiento DOM:

settings.setDomStorageEnabled(true);

• Evita errores de contenido mixto utilizando HTTPS en todas partes.
• Verifica la hora del sistema, la verificación SSL falla si el reloj del dispositivo está incorrecto.
• Agrega localhost a la lista blanca en el panel de administración de Google al probar.

3. “Dominio no válido para la clave del sitio”

Qué está sucediendo:

Ves: ERROR para el propietario del sitio: Dominio no válido para la clave del sitio.

Solución para desarrolladores:

• Inicia sesión en la consola de administración de Google reCAPTCHA.
• Agrega los nombres de dominio correctos (por ejemplo, example.com y www.example.com) — no incluyas http://.
• Usa una clave v2 para checkbox/invisible, y una clave v3 para widgets basados en puntuación. No las mezcles.
• Si es necesario, regenera una nueva clave y actualízala en tu código.

Solución para usuarios:

• Si esto ocurre en un sitio de terceros, no es tu culpa. Puedes intentar acceder a la versión www o no-www de la URL o contactar al soporte del sitio.

4. “Clave del sitio no válida” o “Tipo de clave no válido”

Qué está sucediendo:

El widget aparece roto o falla inmediatamente con errores relacionados con la clave.

Solución para desarrolladores:

• Asegúrate de que la clave del sitio coincida con la versión del widget.

• Las claves v2 solo funcionan con widgets v2.

• Las claves v3 solo funcionan con APIs v3.

• Las claves empresariales requieren llamadas API especiales.

• No confundas clave del sitio con clave secreta —cada una va en un lugar diferente (frontend vs backend).

• Si tu clave fue desactivada o cambiaste tipos, genera una nueva clave y reemplázala en tu configuración.

Solución para usuarios:

• Este es un problema del lado del desarrollador. Puedes intentar refrescar, pero si se está usando la clave incorrecta, solo puede ser solucionado por el propietario del sitio.

5. reCAPTCHA siempre falla la verificación

Qué está sucediendo:

Completes el CAPTCHA, pero el formulario aún no se envía, o dice que la verificación falló.

Solución para desarrolladores:

• Verifica tu solicitud POST del lado del servidor a:

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

• Incluye ambos:

• secret: tu clave secreta

• response: el token g-recaptcha-response del usuario (campo del formulario)

• No conviertas a cadena la solicitud. Utiliza el formato estándar application/x-www-form-urlencoded.

• Si estás usando reCAPTCHA v3:

• Ajusta tu umbral de puntuación. Algunos usuarios pueden recibir una puntuación baja (<0.5) y ser bloqueados.

• Si ves “Sobre el límite gratuito” con puntuaciones altas, significa que el uso excedió los límites.

Solución para usuarios:

• Intenta resolver el CAPTCHA usando la alternativa de audio.
• Borra la caché de tu navegador o cambia a otro navegador.
• Si el problema persiste, repórtalo al equipo de soporte del sitio.

6. “Tu computadora o red pueden estar enviando consultas automatizadas”

Qué está sucediendo:

Google marca tu conexión como sospechosa.

Solución para usuarios:

• Cambia a una red diferente o desconéctate de VPN/proxy.
• Espera unas horas — los límites de tasa son generalmente temporales.
• Si se te solicita, completa los desafíos de CAPTCHA para demostrar que eres humano.

Solución para desarrolladores:

• Verifica si estás provocando bucles que cargan CAPTCHA repetidamente.
• Si muchos usuarios reportan esto, sugiere que cambien de IP o investiga si tu dominio está siendo marcado por Google.

FAQs

¿Por qué no se muestra reCAPTCHA en mi navegador? Puede deberse a bloqueadores de anuncios, un navegador desactualizado, JavaScript deshabilitado o restricciones de red. ¿Cómo soluciono el error de “clave del sitio no válida”? Sí. Simplemente agrega localhost a la lista blanca en el panel de administración de Google reCAPTCHA al crear o editar tu clave. ¿Cuál es la diferencia entre reCAPTCHA v2 y v3? v2 muestra una casilla de verificación o desafío. v3 puntúa la interacción tras bastidores y no requiere interacción del usuario. ¿Funciona reCAPTCHA en modo incógnito? Sí, pero los bloqueadores de anuncios o configuraciones de privacidad más estrictas en modo incógnito pueden interferir con la carga de scripts.

Conclusión

Cuando reCAPTCHA no funciona, el problema a menudo radica en la configuración del navegador, restricciones de red o claves de sitio mal configuradas. Para los usuarios, la solución puede ser tan simple como deshabilitar extensiones o actualizar el navegador. Para los desarrolladores, revisar los detalles de integración, configuraciones de dominio y versiones de API es clave. Si los errores persisten, la documentación de soporte de Google y la consola de administración ofrecen las herramientas finales para la resolución.