Cómo Solucionar el Error de Redis Cache en Magento de Forma Definitiva

Introducción al Error de Redis Cache en Magento

Redis es uno de los sistemas de almacenamiento en caché y gestión de sesiones más potentes utilizados en Magento 2 para garantizar un rendimiento óptimo. Sin embargo, cuando se producen interrupciones en el servicio, problemas de configuración en el archivo env.php o saturación de memoria, tu tienda e-commerce puede arrojar errores críticos de conexión o dejar de funcionar por completo. En este artículo te mostramos cómo solucionar este problema de forma definitiva.

Principales Causas del Fallo de Redis en Magento

Identificar el origen del problema es fundamental antes de aplicar cualquier solución técnica. Las causas más comunes incluyen:

• El servicio de Redis no se está ejecutando en el servidor.
• Credenciales incorrectas o parámetros de puerto/host mal configurados en el archivo app/etc/env.php.
• Agotamiento de la memoria RAM asignada a la instancia de Redis (límite maxmemory alcanzado).
• Bloqueos en el socket de Redis debido a permisos incorrectos.

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

El primer paso consiste en comprobar si el demonio de Redis está activo y operativo en tu servidor VPS o dedicado mediante SSH.

1. Conéctate a tu servidor mediante SSH con privilegios de administrador.
2. Ejecuta el siguiente comando para comprobar el estado del servicio:
   sudo systemctl status redis
3. Si el servicio se encuentra detenido o inactivo, arráncalo con el comando:
   sudo systemctl start redis
4. Configura Redis para que se inicie automáticamente tras un reinicio del sistema:
   sudo systemctl enable redis

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

Si el servicio está activo pero Magento sigue sin conectar, es muy probable que exista una discrepancia en los parámetros de configuración dentro de Magento.

1. Accede a la raíz de tu instalación de Magento y localiza el archivo de configuración:
   app/etc/env.php
2. Abre el archivo con un editor de texto (como nano o vim) y busca la sección correspondiente a cache y session:
   'session' => [ 'save' => 'redis', 'redis' => [ 'host' => '127.0.0.1', 'port' => '6379', 'password' => '', 'timeout' => '2.5', 'persistent_identifier' => '', 'database' => '2', 'compression_threshold' => '2048', 'compression_library' => 'gzip', 'log_level' => '1', 'max_concurrency' => '65536', 'break_after_frontend' => '5', 'break_after_adminhtml' => '30', 'first_lifetime' => '600', 'bot_first_lifetime' => '60', 'bot_lifetime' => '7200', 'disable_locking' => '0', 'allowed_ips' => '127.0.0.1' ] ]
3. Asegúrate de que los valores de host, port y password coincidan exactamente con la configuración de tu servidor Redis.

Método 3: Limpiar la Caché y Reindexar

Una vez corregidos los parámetros de conexión y reiniciado el servicio, debes limpiar el sistema de archivos y la caché de Magento para restablecer el funcionamiento normal.

1. Ejecuta el comando de limpieza de caché de Magento CLI:
   php bin/magento cache:clean
2. Si el problema persiste, limpia el almacenamiento en caché directamente desde la línea de comandos:
   php bin/magento cache:flush
3. Finalmente, verifica que tu tienda vuelva a cargar correctamente accediendo al frontend y al panel de administración (Adminhtml).