Cómo Solucionar el Error de Conexión con 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 almacenamiento en caché y gestión de sesiones más potentes recomendados para Magento 2. Sin embargo, cuando se producen fallos de configuración, saturación de memoria o caídas del servicio, la tienda e-commerce puede dejar de responder por completo, mostrando errores críticos en el front-office y back-office.

Causas Principales del Fallo de Redis en Magento

Las razones más comunes por las que Magento 2 pierde la conexión con Redis incluyen:

• El servicio de Redis se ha detenido o ha crasheado en el servidor VPS o dedicado.
• Límites de memoria RAM superados (maxmemory alcanzado sin una política de desalojo correcta).
• Credenciales incorrectas o parámetros mal configurados en el archivo app/etc/env.php.
• Problemas de permisos o fallos en el socket de UNIX o puerto TCP asignado.

Método 1: Verificar y Reiniciar el Servicio Redis en el Servidor

Lo primero que debemos hacer es comprobar si el demonio de Redis está activo en el servidor. Conéctate mediante SSH con privilegios de administrador y ejecuta los siguientes comandos:

1. Verifica el estado actual del servicio con systemctl: sudo systemctl status redis-server
2. Si el servicio está detenido, inicia o reinicia Redis: sudo systemctl restart redis-server
3. Asegúrate de que el servicio se inicie automáticamente tras un reinicio del sistema: sudo systemctl enable redis-server

Método 2: Comprobar la Configuración en env.php

Si Redis está activo pero Magento sigue sin conectar, debes revisar los parámetros de conexión en el archivo de configuración global de la plataforma.

1. Accede al directorio raíz de tu instalación de Magento: cd /var/www/html/magento2
2. Abre el archivo de configuración con tu editor favorito: nano app/etc/env.php
3. Localiza el bloque correspondiente a cache y session para verificar que el host (ej. 127.0.0.1 o socket) y el puerto (por defecto 6379) coincidan exactamente con la configuración de tu servidor Redis.

Método 3: Limpiar la Caché y Flush de Redis

A veces, la base de datos de Redis se corrompe o se llena por completo, bloqueando las peticiones de Magento. Puedes purgar los datos de Redis y limpiar la caché de Magento de forma segura ejecutando los comandos de consola:

1. Limpia la base de datos de Redis (nota: esto borrará todas las sesiones o cachés almacenadas): redis-cli flushall
2. Limpia la caché interna de Magento 2 mediante el CLI: php bin/magento cache:clean
3. Realiza un flush completo para regenerar los objetos: php bin/magento cache:flush