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

Introducción

Uno de los problemas más frustrantes para los desarrolladores y administradores de tiendas en línea que utilizan este popular CMS e-commerce ocurre cuando el sistema de caché se interrumpe repentinamente. Específicamente, el fallo relacionado con Redis cache not supported o errores de conexión con el backend de Redis puede dejar tu sitio inaccesible, mostrando una excepción general en el frontend y en el panel de administración.

Causas del Error de Redis en Magento 2

Este inconveniente suele originarse por diversas razones técnicas en el servidor o en la configuración de la aplicación:

• La extensión de PHP para Redis (php-redis) no está instalada, está desactualizada o deshabilitada en la versión de PHP activa.
• El servicio de Redis en el servidor Linux se ha detenido o no acepta conexiones en el puerto configurado.
• Credenciales incorrectas, contraseña no coincidente o un socket mal definido en el archivo app/etc/env.php.

Método 1: Verificar e Instalar la Extensión PHP Redis

Lo primero que debes hacer es confirmar si tu servidor cuenta con el módulo necesario para que Magento se comunique con Redis.

1. Accede a tu servidor vía SSH con privilegios de usuario avanzado.
2. Ejecuta el siguiente comando para verificar los módulos de PHP instalados: php -m | grep redis
3. Si el comando no devuelve nada, significa que la extensión no está presente. Instálala ejecutando: sudo apt-get install php-redis (si usas Ubuntu/Debian) o el equivalente para tu gestor de paquetes y versión de PHP (ej. sudo apt-get install php8.1-redis).
4. Reinicia tu servidor web Apache o PHP-FPM para aplicar los cambios: sudo systemctl restart php8.1-fpm.

Método 2: Comprobar el Estado del Servicio Redis

A veces, el problema radica en que el demonio de Redis no se está ejecutando correctamente en la máquina.

1. Comprueba el estado actual del servicio ejecutando: sudo systemctl status redis-server
2. Si se encuentra detenido, inícialo con el comando: sudo systemctl start redis-server
3. Configura Redis para que inicie automáticamente tras un reinicio del sistema: sudo systemctl enable redis-server

Método 3: Revisar la Configuración en env.php

Si los servicios y extensiones funcionan, el fallo podría estar en la declaración dentro de Magento.

1. Abre el archivo de configuración ubicado en la ruta raíz de tu tienda: app/etc/env.php.
2. Busca la sección correspondiente a cache y session para verificar que los parámetros de Redis (como host, port y database) coincidan exactamente con la configuración de tu servidor.
3. Limpia la caché de Magento ejecutando el comando de consola: php bin/magento cache:clean.