Cómo Solucionar el Error de Excepción de Redis Cache en Magento 2 Paso a Paso

Introducción al Error de Redis Cache en Magento 2

Redis es uno de los sistemas de caché y gestión de sesiones más potentes utilizados en Magento 2 para garantizar un rendimiento óptimo en tiendas de alto tráfico. Sin embargo, cuando se producen cortes de servicio, saturación de memoria o problemas de configuración en el archivo env.php, tu plataforma e-commerce puede arrojar excepciones fatales que dejan el sitio inaccesible tanto para los clientes como para los administradores.

Causas Principales del Problema con Redis

Comprender el origen del fallo te ayudará a aplicar la solución correcta. Las causas más comunes incluyen:

• El servicio de Redis se ha detenido o ha caído en el servidor.
• Se ha superado el límite de memoria RAM asignado a Redis (maxmemory), lo que provoca rechazo de nuevas conexiones.
• Credenciales incorrectas o parámetros de host/puerto mal configurados en la sección de caché o sesiones dentro de app/etc/env.php.
• Problemas con los permisos del socket o el archivo de configuración de Redis en el sistema operativo.

Método 1: Verificar y Reiniciar el Servicio de Redis

El primer paso es comprobar si el demonio de Redis está activo en tu servidor y reiniciarlo si es necesario.

1. Accede a tu servidor mediante SSH con privilegios de root o sudo.
2. Ejecuta el siguiente comando para comprobar el estado de Redis: sudo systemctl status redis o sudo systemctl status redis-server.
3. Si el servicio está detenido, inícialo con: sudo systemctl start redis.
4. Para asegurarte de que se reinicie automáticamente tras un reinicio del servidor, habilítalo con: sudo systemctl enable redis.

Método 2: Comprobar y Ampliar el Límite de Memoria en Redis

Si Redis se queda sin memoria, Magento dejará de funcionar y arrojará errores de excepción en el frontend y backend.

1. Abre el archivo de configuración de Redis, generalmente ubicado en /etc/redis/redis.conf usando un editor como nano: sudo nano /etc/redis/redis.conf.
2. Busca la directiva maxmemory y asegúrate de que tenga asignado un valor adecuado para tu servidor (por ejemplo, maxmemory 2gb).
3. Busca la directiva maxmemory-policy y configúrala preferiblemente en allkeys-lru para que Redis elimine las claves menos utilizadas cuando se alcance el límite.
4. Guarda los cambios y reinicia el servicio: sudo systemctl restart redis.

Método 3: Limpiar y Reconfigurar la Caché en Magento

Una vez restablecido el servicio, debes limpiar los registros de caché huérfanos en Magento para estabilizar la plataforma.

1. Navega hasta la raíz de tu instalación de Magento mediante la terminal: cd /var/www/html/tu-tienda-magento.
2. Limpia la caché de Magento utilizando el comando CLI: bin/magento cache:clean.
3. Si el problema persiste, puedes vaciar manualmente el almacenamiento de Redis ejecutando: redis-cli flushall (precaución: esto borrará toda la caché almacenada).
4. Finalmente, realiza una compilación y limpieza general si fuera necesario: bin/magento setup:upgrade.