¿Qué es el Error 504 Gateway Timeout en PrestaShop?
El error 504 Gateway Timeout es uno de los problemas más frustrantes a los que se enfrentan los administradores de tiendas online. Ocurre cuando un servidor que actúa como puerta de enlace o proxy no recibe una respuesta a tiempo de otro servidor al que intentaba acceder para completar la solicitud del cliente. En PrestaShop, esto suele suceder durante procesos pesados como la importación masiva de productos, la generación de la sitemap, o al realizar consultas complejas en bases de datos muy grandes.
Principales Causas del Error 504
Comprender el origen del problema es fundamental para aplicar la solución correcta. Las causas más comunes incluyen:
- Límites de tiempo de espera (timeout) demasiado bajos en servidores web como Nginx o Apache.
- Configuraciones de PHP-FPM restrictivas con tiempos de ejecución (max_execution_time) insuficientes.
- Consultas SQL lentas o pesadas que saturan la base de datos MySQL o MariaDB.
- Problemas temporales o congestión en el servidor proxy inverso (como Varnish o Cloudflare).
Método 1: Aumentar el Timeout en Nginx y PHP-FPM
Si tu servidor utiliza Nginx junto con PHP-FPM, es muy probable que debas ampliar los límites de tiempo de espera en los archivos de configuración.
- Accede a tu servidor mediante SSH con permisos de administrador.
- Abre el archivo de configuración de tu sitio en Nginx, por lo general ubicado en
/etc/nginx/sites-available/tu-tienda.com. - Agrega o modifica las siguientes directivas dentro del bloque
location ~ \.php$:
fastcgi_read_timeout 300;
proxy_read_timeout 300;
proxy_connect_timeout 300;
A continuación, edita el archivo de configuración de PHP-FPM (php.ini) para aumentar el tiempo máximo de ejecución:
max_execution_time = 300
Finalmente, reinicia los servicios para aplicar los cambios ejecutando sudo systemctl restart nginx y sudo systemctl restart php-fpm.
Método 2: Optimizar la Base de Datos desde phpMyAdmin
Las consultas ineficientes o tablas fragmentadas pueden bloquear el servidor y provocar el tiempo de espera agotado.
- Entra a phpMyAdmin desde el panel de control de tu hosting.
- Selecciona la base de datos de tu PrestaShop.
- Selecciona todas las tablas de la lista y, en el menú desplegable inferior, elige Optimizar la tabla.
- Revisa si hay tablas colgadas bloqueadas (procesos largos) utilizando la orden
SHOW PROCESSLIST;en la pestaña SQL.
Método 3: Desactivar Temporalmente Módulos Pesados
A veces, módulos de terceros mal optimizados intentan realizar tareas en segundo plano que superan el tiempo límite establecido.
- Accede al backoffice de tu PrestaShop (si tienes acceso) o directamente vía FTP a la carpeta
/modules/. - Desactiva los módulos añadidos recientemente o aquellos relacionados con estadísticas, marketing y pasarelas de pago.
- Comprueba si el error desaparece al repetir la acción que generaba el fallo. Si se soluciona, contacta con el desarrollador del módulo o manténlo desactivado.