PrestaShop no carga | Solución a pantalla blanca y errores 500

¡Hola! Si estás leyendo esto, probablemente estés frente a la pantalla de tu ordenador con un poco de frustración porque tu tienda online ha decidido tomarse unas vacaciones no planificadas. Ver un mensaje de error o una pantalla en blanco en PrestaShop es uno de los sustos más comunes (y molestos) para cualquier administrador de una tienda online.

Pero no te preocupes, respira hondo. En esta guía extensa y paso a paso, vamos a desglosar las causas más comunes y, sobre todo, las soluciones para arreglar el error de PrestaShop no carga en los paneles de control más usados del mundo: DirectAdmin y cPanel. No necesitas ser un experto en programación para seguir estos pasos; solo necesitas paciencia y acceso a tu panel de hosting.

Vamos a ello.

¿Por qué mi PrestaShop no abre? Entendiendo el problema

Antes de lanzarnos a tocar archivos, es crucial entender qué está pasando. Cuando tu tienda no carga, el problema puede venir de varias fuentes: un archivo corrupto, un problema de permisos, una actualización fallida, o incluso un plugin incompatible. Los síntomas más comunes son:

Pantalla blanca PrestaShop: La página se queda en blanco sin ningún texto. Esto suele indicar un error fatal de PHP que está oculto.
Error 500 PrestaShop: Un error interno del servidor. Es la forma que tiene el servidor de decir "algo se rompió, pero no te voy a dar detalles".
Error de conexión a la base de datos: La tienda intenta conectarse a MySQL y no puede.
Redirecciones infinitas o página de instalación: A veces, si el archivo settings.inc.php se corrompe, la tienda intenta reinstalarse.

El objetivo de este artículo es darte un mapa de ruta para solucionar estos problemas, tanto en DirectAdmin como en cPanel, ya que las herramientas difieren ligeramente, aunque la lógica es la misma.

Fase 1: Diagnóstico Inicial (El Primer Contacto)

No toques nada todavía. Primero, vamos a obtener información. La mayoría de los errores de PrestaShop no carga dejan pistas en los logs del servidor.

Habilitar el modo debug de PrestaShop

PrestaShop tiene un "modo de desarrollador" que muestra los errores en pantalla en lugar de ocultarlos. Esto es oro puro para el diagnóstico.

Accede a tu panel de control (DirectAdmin o cPanel) y busca el Administrador de Archivos.
Navega a la raíz de tu tienda (normalmente public_html o domains/tudominio.com/public_html).
Busca el archivo llamado config/defines.inc.php.
Ábrelo con el editor de texto del panel.
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cambia false por true.
Guarda los cambios.

Ahora, intenta cargar tu tienda de nuevo. En lugar de la pantalla blanca PrestaShop, verás un mensaje de error detallado en la parte superior de la página. Apunta ese mensaje, es la clave para el siguiente paso.

[TIP]: Si no ves el archivo defines.inc.php, activa la opción "Mostrar archivos ocultos" en la configuración del Administrador de Archivos.

Revisar los logs del servidor

Si el modo debug no te da suficiente información (o no puedes activarlo), los logs son tu siguiente mejor amigo.

En cPanel: Busca la sección "Métricas" y haz clic en "Errores". Ahí verás los últimos errores de PHP.
En DirectAdmin: Ve a "Gestión de errores" o revisa la carpeta logs dentro de tu usuario. Normalmente el archivo error_log está en la raíz de public_html.

Busca líneas que contengan "PHP Fatal error" o "PrestaShop". Esa línea te dirá exactamente qué archivo está fallando y por qué.

Fase 2: Las Soluciones Clásicas (Las que funcionan el 80% de las veces)

Con la información del diagnóstico (o incluso sin ella), estos son los pasos más efectivos para solucionar PrestaShop error.

1. Permisos de archivos y carpetas (La causa más común)

Los permisos incorrectos son la principal razón de que PrestaShop no abre. Si los archivos no tienen los permisos adecuados, el servidor no puede leerlos o escribirlos.

La regla de oro es: Carpetas en 755 y Archivos en 644.

Cómo hacerlo en cPanel:

Ve al Administrador de Archivos.
Selecciona todos los archivos y carpetas de la raíz de tu tienda (Ctrl+A o Cmd+A).
Haz clic en "Permisos" en la barra superior.
Marca las casillas para establecer 755 para carpetas y 644 para archivos. Pero ojo, cPanel no distingue entre ambos si seleccionas todo. Por eso, es mejor hacerlo en dos pasos: primero selecciona solo las carpetas (puedes usar el filtro de búsqueda) y luego solo los archivos.

Cómo hacerlo en DirectAdmin:

Ve al Administrador de Archivos.
Navega a public_html.
Selecciona todo y haz clic en "Cambiar permisos".
Al igual que en cPanel, configura las carpetas a 755 y los archivos a 644.

[WARNING]: No pongas permisos 777 (todos los permisos) en tus archivos. Es un agujero de seguridad enorme. Si un plugin te lo pide, es una mala señal.

2. Limpiar la caché de PrestaShop (La solución mágica)

A veces, el problema no es un error, sino una caché corrupta. PrestaShop guarda archivos compilados (.tpl.php) en la carpeta var/cache (o cache en versiones antiguas) y a veces se corrompen.

Solución manual:

Ve a tu Administrador de Archivos.
Busca la carpeta var/cache (o cache).
Entra en ella y borra todo el contenido de las subcarpetas dev y prod. No borres las carpetas en sí, solo su interior.

Solución desde el panel de administración:
Si tu tienda carga el panel de administración (/admin123), ve a Parámetros Avanzados > Rendimiento y haz clic en "Vaciar la caché".

3. Forzar la regeneración del `.htaccess`

El archivo .htaccess es el "director de tráfico" de tu tienda en servidores Apache. Si está corrupto, puede provocar un Error 500 PrestaShop o redirecciones extrañas.

Cómo regenerarlo:

En tu Administrador de Archivos, localiza el archivo .htaccess en la raíz.
Renómbralo a .htaccess.bak (esto lo desactiva sin borrarlo).
Intenta cargar tu tienda. Si ahora carga, el problema era ese archivo.
Para regenerarlo, entra a tu panel de administración de PrestaShop (si puedes) y ve a Parámetros Avanzados > Rendimiento. Marca la casilla "Guardar la optimización de archivos .htaccess" y guarda. Si no puedes entrar, crea un archivo .htaccess vacío en la raíz; PrestaShop lo regenerará en su próximo guardado.

4. Revisar la conexión a la base de datos

Si tu error menciona algo sobre "conexión a la base de datos", el problema está en la configuración de MySQL.

Busca el archivo config/settings.inc.php (en PrestaShop 1.6 y anteriores) o app/config/parameters.php (en PrestaShop 1.7 y 8).
Ábrelo con el editor de texto.
Verifica que los datos (database_host, database_name, database_user, database_password) sean correctos. A veces, al cambiar de servidor o de plan, estas credenciales cambian y no se actualizan.

[INFO]: Si no recuerdas tu contraseña de la base de datos, puedes cambiarla desde MySQL Databases en cPanel o Gestión de MySQL en DirectAdmin. Luego, actualiza el archivo de configuración con la nueva contraseña.

Fase 3: Soluciones Avanzadas (Cuando lo básico falla)

Si has llegado hasta aquí y PrestaShop no carga todavía, vamos a por las soluciones más técnicas.

1. Aumentar el límite de memoria de PHP

A veces, el error es que tu script se queda sin memoria. Esto es común en tiendas grandes o con muchos módulos.

En tu Administrador de Archivos, busca un archivo llamado php.ini en la raíz. Si no existe, créalo.
Pega o edita la siguiente línea:
```
memory_limit = 256M
```
Guarda el archivo.

Si no funciona, en cPanel puedes usar el selector de "Versión PHP" para cambiar el memory_limit desde la interfaz. En DirectAdmin, puedes editarlo desde la sección "Configuración de PHP".

2. Deshabilitar un módulo problemático (Sin acceso al panel)

Imagina que el error comenzó justo después de instalar un módulo. Si no puedes acceder al panel de administración para desinstalarlo, tendrás que hacerlo por la fuerza.

Ve a tu Administrador de Archivos.
Navega a modules/.
Busca la carpeta del módulo sospechoso (la que instalaste antes del error).
Renómbrala (ej. de micodigo a micodigo_off). Esto desactivará el módulo.

Si la tienda carga, ya sabes quién es el culpable. Puedes intentar actualizar el módulo o contactar al desarrollador.

3. Revisar la versión de PHP

PrestaShop es exigente con las versiones de PHP. Si tu hosting actualizó la versión y tu tienda es antigua, puede que no sea compatible.

PrestaShop 1.6 necesita PHP 5.6 o 7.0 como máximo.
PrestaShop 1.7 necesita PHP 7.1 o superior (idealmente 7.4 o 8.0).
PrestaShop 8 necesita PHP 7.3 o superior.

Cómo cambiarlo:

En cPanel: Busca "Select PHP Version" y elige la versión adecuada.
En DirectAdmin: Ve a "Configuración de PHP" y selecciona la versión compatible.

[WARNING]: Cambiar la versión de PHP puede romper otras cosas si tu web es muy antigua. Hazlo con cuidado y prueba después de cada cambio.

4. Verificar los archivos del núcleo (Core)

Si sospechas que un archivo se ha corrompido o ha sido modificado por un malware, la solución más limpia es sobrescribir los archivos del núcleo de PrestaShop.

Descarga la misma versión de PrestaShop que tienes instalada desde el sitio oficial de PrestaShop.
Descomprime el archivo en tu ordenador.
Sube solo la carpeta admin (renómbrala con el nombre de tu admin actual), config, classes, controllers, src, vendor y themes (solo el tema por defecto, no el tuyo) a tu servidor, sobrescribiendo los existentes.

No subas la carpeta modules ni img, ya que perderías tus personalizaciones y productos.

Fase 4: El Plan B (Recuperar acceso)

¿Aún no lo has conseguido? No pasa nada. A veces la solución requiere una intervención más profunda, pero todavía tienes opciones.

1. Revisar el cron job

Un cron job mal configurado puede saturar el servidor. Ve a la sección "Cron Jobs" en cPanel o DirectAdmin y desactívalos temporalmente para ver si el problema se resuelve.

2. Contactar con tu proveedor de hosting

Si has seguido todos estos pasos y PrestaShop no abre, es hora de llamar a los profesionales. Tu proveedor de hosting tiene acceso a logs del servidor que tú no ves. Explícales qué has hecho y muéstrales el error exacto que obtienes. Ellos podrán ver si es un problema de recursos del servidor (CPU o memoria) o de configuración del servidor.

[TIP]: A veces, el problema no es tu tienda, sino un vecino en el servidor que está consumiendo todos los recursos. Tu hosting puede reubicarte en un servidor menos saturado.

Preguntas Frecuentes (FAQ) Rápidas

Para terminar, aquí tienes respuestas rápidas a las dudas más comunes:

¿Cuál es la causa más común del error 500 en PrestaShop?
La causa más común es una mala configuración de permisos de archivos, seguida de un .htaccess corrupto y un aumento repentino de la memoria necesaria.

¿Por qué veo una pantalla en blanco pero el código fuente tiene errores?
Eso es un error fatal de PHP que está siendo "silenciado" por la configuración. Activa el modo debug (como explicamos al principio) para verlo en pantalla.

¿Puedo perder mis productos si borro la caché?
No, la caché solo almacena archivos temporales compilados. Tus productos y pedidos están en la base de datos, que no se toca.

¿Qué hago si el error persiste después de actualizar PrestaShop?
Las actualizaciones a veces dejan restos. Desactiva todos los módulos no oficiales y cambia al tema por defecto. Si el error desaparece, el problema es un módulo o tema incompatible.

¿Es seguro usar Syspanel como panel de control?
Sí, Syspanel (antiguamente conocido como HestiaCP) es una excelente alternativa a cPanel o DirectAdmin. Es ligero y muy seguro. Recuerda que para acceder a su panel de administración, la URL debe incluir el puerto 2106 (ej: https://tudominio.com:2106).

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Ve paso a paso, sin prisas, y seguro que consigues que tu tienda vuelva a estar en línea. ¡Mucha suerte!