Cómo Solucionar el Error 500 o Pantalla Blanca en PrestaShop de Forma Definitiva

¿Qué es el Error 500 o Pantalla Blanca en PrestaShop?

El Error 500 (Internal Server Error) o la temida pantalla blanca de la muerte en PrestaShop ocurre cuando el servidor web encuentra una condición inesperada que le impide completar la solicitud. Por motivos de seguridad, PrestaShop oculta los detalles del error al usuario final, mostrando una página en blanco o un mensaje genérico. Esto dificulta el diagnóstico inicial para los administradores de la tienda online.

Causas comunes del Error 500 en PrestaShop

• Incompatibilidad de módulos: Un módulo recientemente instalado o actualizado que no es compatible con tu versión de PrestaShop o de PHP.
• Errores de sintaxis en Smarty: Modificaciones incorrectas en los archivos de plantilla (.tpl).
• Límite de memoria PHP insuficiente: El servidor agota la memoria asignada antes de poder renderizar la página.
• Permisos de archivos incorrectos: Permisos inadecuados en carpetas clave como /cache, /var o /modules.

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

Para solucionar el problema, primero debes averiguar exactamente qué archivo o línea de código está fallando. Activar el modo depuración te permitirá ver el mensaje de error real en pantalla.

1. Accede a los archivos de tu servidor mediante un cliente FTP (como FileZilla) o desde el Administrador de Archivos de tu panel de hosting (cPanel/Plesk).
2. Navega hasta el directorio raíz de tu tienda PrestaShop y abre la carpeta config.
3. Edita el archivo llamado defines.inc.php.
4. Busca la siguiente línea de código (suele estar cerca de la línea 29):
   define('_PS_MODE_DEV_', false);
5. Cambia el valor de false a true para activar el entorno de desarrollo:
   define('_PS_MODE_DEV_', true);
6. Guarda los cambios y sube el archivo de nuevo al servidor.

Una vez hecho esto, recarga la página que fallaba. En lugar de la pantalla blanca, verás un informe detallado de PHP que te indicará la ruta del archivo conflictivo (comúnmente un módulo en la carpeta /modules/).

Método 2: Limpiar la caché de PrestaShop manualmente

En muchas ocasiones, archivos corruptos en la caché de compilación de Smarty o Symfony provocan el Error 500. Si no puedes acceder al panel de administración (Back Office), debes borrar la caché manualmente.

1. Conéctate a tu servidor FTP o cPanel.
2. Navega a la ruta /var/cache/ en PrestaShop 1.7 o superior (en versiones 1.6, ve a /cache/smarty/compile/ y /cache/smarty/cache/).
3. Verás dos carpetas principales: dev (desarrollo) y prod (producción).
4. Elimina por completo el contenido de ambas carpetas. PrestaShop regenerará automáticamente estos archivos de manera limpia la próxima vez que cargues el sitio.

Método 3: Desactivar módulos conflictivos desde la base de datos

Si el informe de error del Método 1 apunta a un módulo específico y no puedes acceder al Back Office para desactivarlo, puedes hacerlo directamente desde tu base de datos a través de phpMyAdmin.

1. Accede a tu panel de hosting y abre la herramienta phpMyAdmin.
2. Selecciona la base de datos de tu tienda y busca la tabla ps_module (el prefijo ps_ puede variar según tu instalación).
3. Usa el buscador para localizar el módulo que causa el fallo introduciendo su nombre en la columna name.
4. Edita la fila correspondiente y cambia el valor de la columna active de 1 (activo) a 0 (inactivo).
5. Guarda los cambios. El módulo problemático quedará desactivado inmediatamente, restaurando el acceso a tu tienda.