¿Qué es el Error 504 Gateway Timeout en PrestaShop?

El error 504 Gateway Timeout ocurre cuando un servidor que actúa como puerta de enlace o proxy no recibe una respuesta a tiempo de otro servidor al intentar cargar una página de tu tienda online en PrestaShop. En el ecosistema de PrestaShop, este fallo suele manifestarse al realizar consultas pesadas en la base de datos, al importar un catálogo grande de productos, o durante la ejecución de tareas pesadas en el backoffice.

Principales Causas del Error 504

• Tiempos de espera (timeouts) configurados de forma demasiado estricta en el servidor web (Nginx o Apache).
• Límites insuficientes de tiempo de ejecución en PHP (max_execution_time).
• Consultas SQL lentas o una base de datos de PrestaShop sobrecargada de datos obsoletos (logs de depuración, estadísticas de carritos, etc.).
• Problemas temporales de conectividad entre el servidor proxy inverso (como Nginx) y el backend (como Apache o PHP-FPM).

Método 1: Aumentar el Tiempo de Espera 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 respuesta configurados en los archivos de configuración del servidor.

1. Accede a tu servidor mediante SSH con privilegios de administrador.
2. Abre el archivo de configuración de tu sitio en Nginx o el archivo global nginx.conf.
3. Modifica o añade las siguientes directivas dentro del bloque location ~ \.php$:
   fastcgi_read_timeout 300s;
proxy_read_timeout 300s;
proxy_connect_timeout 300s;
4. Edita también tu archivo php.ini y localiza la variable max_execution_time, aumentándola a 300 o más:
   max_execution_time = 300
5. Reinicia los servicios ejecutando sudo systemctl restart nginx y sudo systemctl restart php-fpm.

Método 2: Optimizar y Limpiar la Base de Datos desde phpMyAdmin

Una base de datos saturada de logs y tablas fragmentadas puede ralentizar las consultas hasta provocar el tiempo de espera agotado.

1. Entra a tu panel de control de hosting y abre phpMyAdmin.
2. Selecciona la base de datos correspondiente a tu instalación de PrestaShop.
3. Busca tablas como ps_connections, ps_connections_source, ps_log o ps_mail que suelen acumular millones de registros inútiles.
4. Vacía estas tablas utilizando la sentencia SQL TRUNCATE TABLE nombre_de_tabla; (cuidado de no borrar tablas esenciales de clientes o pedidos).
5. Ejecuta la opción de optimizar tabla para liberar espacio y reorganizar los índices.

Método 3: Configurar Correctamente los Módulos Pesados

Ciertos módulos de marketing, pasarelas de pago o sincronizadores con ERPs realizan peticiones pesadas que superan el tiempo límite establecido.

1. Entra al Backoffice de tu PrestaShop y ve a Parámetros Avanzados > Rendimiento.

Desactiva temporalmente los módulos no nativos que sospeches que generan llamadas AJAX constantes o consultas externas lentas.

2. Comprueba si el error desaparece al repetir la acción que lo provocaba.
3. Contacta con el desarrollador del módulo para reportar problemas de rendimiento si el error persiste al habilitarlo.