¿Error 500 o pantalla en blanco en PrestaShop? Te enseño como solucionarlo

Un error 500 en Prestashop es una anomalía que puede aparecer, si estabas intentando actualizar una plantilla, instalando un módulo o cualquier otra condición que ha fallado y hace que el servidor no pueda responder correctamente.

¿Qué significa un error 500 en PrestaShop?

Si navegando por una tienda online, aparece un cartel de “Error http 500” quiere decir que estamos frente a un error interno que no ha podido resolver el servidor, el aspecto del error 500 sería la siguiente imagen o una pantalla en blanco directamente:

El error indica que el servidor donde se encuentre alojada la web o tienda online, presenta fallos. Según el servidor contratado puede que la frase de alerta, contenga alguna variación. Por ejemplo: 500 error interno del servidor, Http 500, Error 500, Error http 500, entre otros. Pero debes saber, que de cualquier forma todos se refieren al mismo error.

Cómo resolver el error 500 o pantalla en blanco en PrestaShop

Para resolver este error debemos seguir una serie de pasos.

Activación modo debug PrestaShop

Como primera medida, tenemos que activar en PrestaShop el modo debug.

Para activar el modo debug realizamos los siguientes pasos:

1. Abre /config/defines.inc.php
2. Sobre la línea 28 tendrás la siguiente línea: define(‘_PS_MODE_DEV_’,false); 
3. A continuación, cambiarla por : define(‘_PS_MODE_DEV_’,true);

Una vez activado el modo debug nos mostrará por pantalla la ruta de las llamadas que contienen el error, por ejemplo en la siguiente captura vemos que el error viene de un módulo que tendríamos que desactivar o ver el error que nos da en el código del módulo:

Podemos ver diferentes pantallas de este estilo donde se nos mostrará los errores, os comento algunos errores que he visto más comunes:

1. Error por falta de permisos
2. Error 500 el cual hay que revisar el fichero .htaccess
3. Variable no definida por ejemplo el acceso a un pedido que tiene una dirección de envio que no existe
4. Módulo no compatible con la versión de PHP del servidor
5. Función con X variables de entrada y la llamada a esta función no contiene las variables de entrada
6. Consulta SQL incorrecta en algún controller «Column not found»

Finalmente, si ya solucionamos el error 500 prestashop, debes volver a colocar ‘_PS_MODE_DEV_’, false.

Revisión error_log

Otra manera de ver los errores que pueda tener nuestra web, es revisando los logs, pero ¿qué son los logs? Los logs son archivos que registran cualquier evento dentro del sistema, desde errores a problemas menores los cuales podemos ver la fecha exacta cuando se ha producto el error e información sobre el mismo.

Para ver los logs en el servidor, nos vamos al directorio /logs y abrimos el fichero error_log

Al abrir este fichero nos encontramos un error:

[Tue Apr 23 11:41:40.292230 2024] [proxy_fcgi:error] [pid 25324:tid 140227645462272] [client 125.216.249.172:57945] AH01071: Got error 'PHP message: PHP Warning: unlink(/var/www/vhosts/miweb.com/httpdocs/var/cache/prod/hspointofsalepro_80caa1186e0ce47da3f7eb66b036384e_4.3.1.php): No such file or directory in /var/www/vhosts/miweb.com/httpdocs/modules/hspointofsalepro/classes/hs/HsAutoload.php on line 167', referer: https://rmiweb.com/es/pulseras/pulsera-arbol-753

Al desactivar el módulo de hspointofsalepro ya volvio a la normalidad, por lo que sabemos la pantalla en blanco provenia desde módulo.

Ver consola del navegador

Otro error 500 es el de Gateway timeout cuando el servidor dice «basta» a una petición que podemos ver desde consola:

En este caso podemos ver que hay una llamada a las categorías que tarda más de 5 minutos en cargar y el servidor nos devuelve Request Timeout, en este caso era al entrar al backoffice de la sección de categorías el calculo de las mejores categorías que no tenía suficiente tiempo el servidor para este calculo.

Si bien el error 500 en PrestaShop, se sabe que procede de alguna petición incompleta por parte del servidor, puede que las causas, no sepas donde se produjo o el por qué, en este post te explico como detectar el problema de 3 formas diferentes. Independientemente del resultado, te invito a seguir de cerca mi blog, donde siempre encontrarás cómo resolver los problemas que puedan surgir en PrestaShop. Y si necesitas hacerte con un experto en PrestaShop ¡Contacta a través del formulario! Hasta la próxima 😀