Error establishing a Redis connection

Error establishing a Redis connection en WordPress: solución

Error establishing a Redis connection en WordPress: solución

Error establishing a Redis connection es de esos mensajes que cualquier administrador de WordPress con Redis como caché de objetos ha visto más de una vez. Aparece cuando el sitio no logra comunicarse con el servidor de Redis, y las consecuencias se notan enseguida: páginas lentas, errores 500, a veces el sitio entero caído. La buena noticia (y lo comprobamos a diario) es que casi siempre hay una causa puntual detrás y una solución rápida, si sabes dónde mirar. Aquí te explicamos qué significa exactamente el error, sus causas más habituales y los primeros pasos de diagnóstico, con comandos concretos que puedes ejecutar ahora mismo en tu servidor.

¿Qué significa el error establishing a Redis connection en WordPress?

El mensaje aparece cuando el plugin que integra WordPress con Redis (normalmente Redis Object Cache, o la caché de plugins como W3 Total Cache o LiteSpeed Cache) intenta conectar con el servidor Redis y no recibe respuesta. En pantalla se muestra el texto literal «Error establishing a Redis connection», a veces acompañado de detalles técnicos: Connection refused, Connection timed out, errores de autenticación…

Conviene entender primero qué hace Redis. Es una capa de caché de objetos en memoria: guarda resultados de consultas a la base de datos, transitorios y otros datos recurrentes para acelerar la carga. Cuando esa capa deja de estar disponible, WordPress puede seguir funcionando sin caché, pero muchos plugins intentan reconectar en cada petición, y eso genera sobrecarga y una lentitud extrema. Si además tu wp-config.php fuerza Redis mediante WP_REDIS_HOST, el sitio puede quedarse bloqueado esperando una respuesta que nunca llega.

Consejo: antes de tocar nada, anota el mensaje completo que aparece bajo el error. Ese detalle (refused, timeout, auth) te dirá directamente qué causa tratar primero.

Causas más comunes del error de conexión con Redis

Llevamos años diagnosticando este problema en RedServicio y las causas se repiten una y otra vez:

  • Servicio Redis detenido o caído: el demonio redis-server se ha parado tras un reinicio del servidor, un fallo de memoria o un update del sistema.
  • Redis no está instalado en el servidor: especialmente frecuente tras migrar a un hosting nuevo que no lo incluye por defecto.
  • Credenciales incorrectas: Redis protegido con contraseña (requerirpass) pero WordPress no la tiene en WP_REDIS_PASSWORD. O al revés.
  • Puerto o host mal configurados: Redis escucha en un socket Unix o en un puerto distinto al 6379, y WordPress apunta al lugar equivocado.
  • Redis reiniciado y base de datos vacía: la caché se perdió, y eso produce errores temporales hasta que se reconstruye.
  • Límite de memoria agotado: con maxmemory al tope, Redis rechaza nuevas escrituras y algunos clientes interpretan esto como fallo de conexión.
  • Firewall o aislamiento entre contenedores: en entornos Docker o VPS con web y base de datos separadas, el puerto 6379 no es accesible desde el contenedor de WordPress.

Identificar bien la causa evita perder tiempo con soluciones que no aplican a tu caso. Por eso conviene seguir un orden de diagnóstico lógico.

Verificar que Redis está instalado y en ejecución

Primero lo primero: comprobar si el servicio está realmente activo. Accede por SSH y ejecuta:

systemctl status redis (o redis-server, según la distribución). Si está inactivo, arráncalo y habilítalo para que arranque con el sistema:

  1. sudo systemctl start redis
  2. sudo systemctl enable redis
  3. Verifica la conexión con redis-cli ping; la respuesta correcta es PONG.

¿Te sale Could not connect to Redis at 127.0.0.1:6379: Connection refused? Entonces el servicio no está escuchando. Revisa los logs con sudo journalctl -u redis -n 50 o consulta /var/log/redis/redis-server.log para detectar errores de configuración o de memoria. Un detalle que despista a más de uno: en Debian el paquete puede llamarse redis-server en vez de redis, así que tenlo en cuenta al ejecutar los comandos.

Si Redis responde con PONG pero WordPress sigue mostrando el error, el problema está en la configuración de conexión o en las credenciales. De eso tratamos en la siguiente parte de esta guía.

Revisar la configuración de Redis en wp-config.php

Lo más habitual, casi siempre, es que el error establishing a Redis connection tras una migración o cambio de hosting venga de una configuración incorrecta en wp-config.php. Ábrelo con un editor de texto o desde el gestor de archivos de tu panel y busca el bloque de constantes de Redis. Como mínimo debería tener estas líneas:

  • WP_REDIS_HOST: la IP o el hostname del servidor Redis. Si Redis corre en el mismo servidor que WordPress, lo normal es que el valor sea 127.0.0.1. Pero ojo: en hosting compartido o con contenedores puede ser un nombre interno tipo redis o una IP privada.
  • WP_REDIS_PORT: el puerto de escucha, normalmente 6379. Algunos proveedores usan puertos alternativos. Verifícalo con redis-cli -p PUERTO ping.
  • WP_REDIS_PREFIX: opcional, aunque yo lo pondría siempre. Evita colisiones de claves cuando varios sitios comparten la misma instancia.

Un ejemplo de configuración válida:

define( ‘WP_REDIS_HOST’, ‘127.0.0.1’ ); define( ‘WP_REDIS_PORT’, 6379 ); define( ‘WP_REDIS_PREFIX’, ‘misitio:’ );

Hay un detalle que genera muchos errores silenciosos: si la configuración incluye WP_REDIS_PATH (conexión por socket Unix), la constante WP_REDIS_SCHEME tiene que estar definida como unix. Mezclar socket y TCP en la misma configuración provoca fallos que no dan pistas claras. Aprovecha también para comprobar que el plugin Redis Object Cache está activado y que el objeto de caché aparece como conectado en la sección Herramientas de WordPress.

Comprobar credenciales, puerto y estado del servicio Redis

¿El archivo parece correcto pero el error sigue ahí? Entonces toca validar credenciales y estado del servicio. Desde la línea de comandos, prueba una conexión autenticada:

  • redis-cli -h 127.0.0.1 -p 6379 ping: sin contraseña. Debe responder PONG.
  • redis-cli -h 127.0.0.1 -p 6379 -a TU_PASSWORD ping: con autenticación. Comprueba que la clave coincide exactamente —exacta, sin espacios de más— con la definida en WP_REDIS_PASSWORD en wp-config.php.

Si recibes un error de autenticación (NOAUTH o WRONGPASS), la contraseña del servidor Redis cambió y debes actualizarla también en WordPress. Si en cambio sale «Connection refused», el servicio no está escuchando en ese puerto o está detenido. Reinícialo con systemctl restart redis y revisa que en redis.conf la directiva bind incluya la IP que usa WordPress y que protected-mode no esté bloqueando conexiones remotas legítimas.

Otro punto que casi nadie mira: si usas fail2ban, un firewall como CSF o reglas iptables, asegúrate de que la IP de origen de WordPress tenga permiso para llegar al puerto 6379. Y en servidores con Docker, comprueba que ambos contenedores comparten la misma red.

Consejo rápido: después de cualquier cambio en credenciales o puertos, ejecuta wp redis enable (con WP-CLI) o desactiva y reactiva el plugin Redis Object Cache para forzar una reconexión limpia.

Conclusión: cómo evitar el error establishing a Redis connection en el futuro

El error establishing a Redis connection casi nunca es aleatorio. Responde a una cadena verificable de causas que, revisadas en orden, se resuelven en pocos minutos. Primero comprueba que el servicio Redis está activo y responde con PONG. Después valida host, puerto y credenciales en wp-config.php. Y por último descarta bloqueos de firewall o incompatibilidades del plugin de caché.

Para que no vuelva a ocurrir, te recomiendo estas prácticas:

  1. Documenta la configuración de Redis de cada sitio y actualízala cuando cambies de servidor o de contraseña.
  2. Configura el servicio para que arranque solo tras un reinicio del servidor con systemctl enable redis.
  3. Antes de migrar o actualizar WordPress, desactiva temporalmente la caché de objetos. Si Redis falla, no querrás que el sitio se caiga entero.
  4. Vigila los logs de Redis y de PHP para detectar conexiones rechazadas antes de que las noten los visitantes.

Con Redis bien configurado, las páginas cargan bastante más rápido y la base de datos respire. Si el problema se resiste o prefieres no tocar archivos de configuración en producción (algo razonable, la verdad), en RedServicio (redservicio.net) tienen soporte técnico especializado en WordPress y administración de servidores que puede diagnosticar y resolver el error por ti sin riesgos.

Publicaciones Similares