Cómo Solucionar la Pantalla Blanca o Error 500 en PrestaShop Paso a Paso

¿Qué Causa la Pantalla Blanca o Error 500 en PrestaShop?

La temida pantalla blanca (conocida como White Screen of Death o HTTP Error 500) en PrestaShop ocurre cuando el servidor web encuentra un error fatal de PHP durante la ejecución del script y, por motivos de seguridad predeterminados, oculta el mensaje de error al usuario. Este fallo puede originarse tanto en el Front Office como en el Backoffice.

Las causas más habituales detrás de este problema incluyen:

• Incompatibilidad tras instalar o actualizar un módulo o tema.
• Límite de memoria PHP insuficiente (memory_limit).
• Versión de PHP incompatible con la versión instalada de PrestaShop.
• Archivos de caché corruptos en el directorio del sistema.
• Permisos incorrectos en carpetas y archivos críticos.

Método 1: Activar el Modo Depuración (Debug Mode) para Identificar el Fallo

Para solucionar el problema, el primer paso esencial es hacer visible el error específico modificando los archivos de configuración mediante FTP o el Administrador de Archivos de cPanel.

1. Accede a los archivos de tu tienda mediante un cliente FTP (como FileZilla) o desde el panel de control de tu hosting.
2. Navega a la ruta: config/defines.inc.php.
3. Abre el archivo con un editor de texto y busca la siguiente línea: define('_PS_MODE_DEV_', false);.
4. Cambia el valor false por true para que quede así: define('_PS_MODE_DEV_', true);.
5. Guarda los cambios y recarga la página de tu tienda que presentaba la pantalla en blanco.

Ahora verás la traza detallada del error con el archivo y la línea exacta donde se originó el fallo, lo que te permitirá saber si pertenece a un módulo específico o al núcleo de PrestaShop.

Método 2: Desactivar el Módulo Conflictivo Vía FTP

Si la pantalla de depuración indica que el fallo proviene de una carpeta dentro de /modules/, debes desactivar dicho módulo de forma manual:

1. Dirígete a la carpeta modules/ en la raíz de tu instalación.
2. Localiza la carpeta del módulo causante del error (por ejemplo, moduloconflicto).
3. Renombra la carpeta añadiendo un sufijo temporal, por ejemplo: moduloconflicto_desactivado.
4. Recarga tu tienda. PrestaShop ignorará la ejecución del módulo y la tienda volverá a estar operativa de inmediato.

Método 3: Limpiar la Caché Manualmente

A menudo, una caché corrupta después de una actualización genera bloqueos de ejecución en el motor Smarty o Symfony. Para vaciarla manualmente:

1. En PrestaShop 1.7 o 8.x, accede a la carpeta var/cache/.
2. Elimina por completo las carpetas prod y dev situadas en ese directorio. PrestaShop las regenerará automáticamente en la siguiente petición.
3. Si utilizas PrestaShop 1.6, accede a cache/smarty/compile y cache/smarty/cache y elimina todos los archivos excepto index.php.

Método 4: Incrementar los Límites de PHP

Si el error indica un agotamiento de memoria como Allowed memory size of X bytes exhausted, debes ampliar los recursos en el archivo php.ini o .htaccess:

• Asegúrate de que la directiva memory_limit tenga al menos 256M o 512M.
• Aumenta el tiempo de ejecución con max_execution_time = 300.

Una vez restablecido el funcionamiento de la tienda, recuerda volver a cambiar _PS_MODE_DEV_ a false en defines.inc.php por razones de seguridad y privacidad.