¿Qué es el error 503 Backend Fetch Failed en Magento 2?
El error 503 Backend Fetch Failed es un problema común en tiendas de comercio electrónico impulsadas por Magento 2 (Adobe Commerce) que utilizan Varnish como servidor de caché HTTP inverso. Este código de estado HTTP indica que Varnish no ha podido comunicarse correctamente con el servidor de origen (por lo general, Apache o Nginx), lo que impide que la página web se cargue para los clientes.
Causas principales del error en Magento
- El servicio de Apache o Nginx se ha detenido o ha fallado inesperadamente.
- PHP-FPM ha alcanzado su límite máximo de procesos o memoria permitida.
- Configuración incorrecta del archivo de configuración de Varnish (
default.vcl). - Problemas de latencia o saturación en la base de datos MySQL/MariaDB.
Método 1: Reiniciar los servicios web y PHP-FPM
Lo primero que debes hacer es comprobar el estado de los servicios web en tu servidor VPS o dedicado mediante SSH.
- Conéctate a tu servidor mediante SSH con privilegios de administrador.
- Verifica y reinicia el servidor web (Nginx o Apache). Si usas Nginx, ejecuta:
sudo systemctl restart nginx - Reinicia el servicio PHP-FPM asegurándote de usar tu versión correspondiente (ejemplo PHP 8.1):
sudo systemctl restart php8.1-fpm - Reinicia el servicio de Varnish Cache:
sudo systemctl restart varnish
Método 2: Aumentar los límites de tiempo de espera (Timeouts)
A menudo, Varnish se desliga del backend si Magento tarda demasiado en procesar una solicitud pesada. Debes ajustar los parámetros de tiempo de espera.
- Abre tu archivo de configuración VCL, comúnmente ubicado en
/etc/varnish/default.vcl. - Busca los bloques de backend y añade o modifica las siguientes líneas para incrementar el tiempo de espera:
.first_byte_timeout = 300s;,.connect_timeout = 5s;y.between_bytes_timeout = 60s;. - Guarda los cambios y aplica la nueva configuración recargando Varnish:
sudo systemctl reload varnish
Método 3: Limpiar y refrescar la caché de Magento
Si el problema persiste, es recomendable vaciar la caché interna de la plataforma a través de la interfaz de comandos CLI de Magento.
- Navega hasta la raíz de tu instalación de Magento:
cd /var/www/html/tu-tienda-magento - Ejecuta el comando para limpiar el almacenamiento temporal:
php bin/magento cache:clean - Limpia también la caché de Varnish desde la consola si tienes el módulo configurado, o simplemente reinicia el servicio Varnish una vez más para purgar todos los objetos almacenados.