PrestaShop no carga: Soluciones para el panel admin

Introducción: Cuando PrestaShop se convierte en un dolor de cabeza

Si estás leyendo esto, probablemente estés frente a la pantalla con el mensaje de error en blanco, un bucle de carga infinita o un error 500 en tu tienda. PrestaShop no carga y el pánico empieza a aparecer. Respira.

Este problema es mucho más común de lo que imaginas. Miles de comercios electrónicos basados en PrestaShop experimentan fallos en el panel de administración cada día. La buena noticia es que la mayoría de las soluciones son sencillas y puedes aplicarlas tú mismo sin necesidad de ser un experto en programación.

A lo largo de esta guía, voy a explicarte paso a paso las 7 soluciones más efectivas para cuando el panel de PrestaShop no funciona. Todas están pensadas para que cualquier persona, sin conocimientos técnicos avanzados, pueda intentarlo antes de llamar a un profesional.

Vamos a empezar con lo más básico y avanzaremos hacia soluciones más complejas. Recuerda: siempre haz una copia de seguridad antes de modificar cualquier archivo.

1. Limpiar la caché de PrestaShop

¿Por qué falla la caché?

La caché es un sistema de almacenamiento temporal que usa PrestaShop para cargar las páginas más rápido. Cuando algo se corrompe en esta caché, el panel de PrestaShop no abre o muestra contenido desactualizado.

Cómo limpiar la caché sin acceso al panel

Si no puedes entrar al panel de administración, tendrás que hacerlo por FTP o desde el administrador de archivos de tu hosting.

Accede a tu hosting mediante FTP (FileZilla es gratuito y muy fácil de usar) o desde el panel de control de tu hosting.
Navega hasta la carpeta donde tienes instalado PrestaShop, normalmente public_html o htdocs.
Localiza la carpeta /var/cache/ dentro de la raíz de PrestaShop.
Dentro de esta carpeta encontrarás subcarpetas como dev, prod o archivos con extensión .php. Borra todo el contenido de la carpeta cache pero no la carpeta en sí.
También puedes borrar el contenido de /cache/smarty/compile y /cache/smarty/cache.

[TIP] Si usas un hosting con cPanel, puedes usar el administrador de archivos para borrar estos archivos sin necesidad de FTP. En Syspanel (puerto 2106) también encontrarás un gestor de archivos integrado.

¿Qué pasa si no encuentro la carpeta cache?

Algunas versiones de PrestaShop o configuraciones de hosting pueden tener la caché en otra ubicación. Busca en la raíz de tu instalación archivos con nombres como class_index.php o carpetas que empiecen por cache. Si no encuentras nada, ve a la solución número 2.

2. Verificar los permisos de archivos y carpetas

El problema clásico de los permisos 777

Cuando PrestaShop no carga, una de las causas más frecuentes son los permisos incorrectos en archivos y carpetas. Si los permisos son demasiado restrictivos, el sistema no puede leer o escribir los archivos necesarios.

Cómo corregir los permisos

Conéctate por FTP a tu servidor.
Selecciona todos los archivos y carpetas de la raíz de PrestaShop.
Haz clic derecho y selecciona "Permisos de archivo" o "File permissions".
Establece los siguientes valores:
- Carpetas: 755
- Archivos: 644
Hay una excepción importante: la carpeta /config y /var/cache deben tener permisos 777 en algunos casos.

[WARNING] No dejes todos los archivos con permisos 777 de forma permanente. Es un riesgo de seguridad grave. Después de solucionar el problema, vuelve a poner 755 y 644.

Permisos específicos para el panel de administración

Si solo el admin de PrestaShop no abre pero la tienda funciona, revisa los permisos de la carpeta /admin (o el nombre personalizado que hayas usado). A veces, al actualizar la versión, estos permisos se modifican y bloquean el acceso.

3. Desactivar el modo mantenimiento y errores de PHP

El misterio del error 500

Cuando el panel de PrestaShop no funciona y ves un error 500, es señal de que hay un problema con PHP. La mayoría de los hosting ocultan los errores por defecto, así que no ves nada más que una página en blanco.

Activar la visualización de errores

Abre el archivo config/defines.inc.php desde FTP.
Busca la línea que dice define('_PS_MODE_DEV_', false);
Cambia false por true.
Guarda el archivo y sube los cambios.
Ahora intenta acceder al panel. Verás los errores reales en pantalla, lo que te dará pistas sobre qué está fallando.

[INFO] Una vez que hayas solucionado el problema, vuelve a poner false para que los clientes no vean los errores técnicos.

Solución rápida si no puedes editar archivos

Si no puedes editar el archivo defines.inc.php, crea un archivo llamado php.ini en la raíz de tu PrestaShop con el siguiente contenido:

display_errors = On

Esto activará la visualización de errores sin modificar los archivos de PrestaShop.

4. Comprobar la base de datos y su conexión

Cuando la base de datos es la culpable

Muchas veces, PrestaShop no carga porque la conexión a la base de datos falla. Esto puede deberse a que la base de datos está llena, corrupta o las credenciales han cambiado.

Verificar la configuración de conexión

Abre el archivo app/config/parameters.php (en PrestaShop 1.7 y superiores) o config/settings.inc.php (en versiones 1.6).
Revisa los valores de database_host, database_name, database_user y database_password.
Comprueba que coinciden con los datos de tu hosting.

[TIP] Si recientemente cambiaste la contraseña de tu base de datos y no actualizaste este archivo, ese es el problema.

Reparar la base de datos desde el hosting

La mayoría de los paneles de hosting (incluido Syspanel, que puedes acceder en el puerto 2106) tienen una herramienta para reparar bases de datos MySQL. Busca la opción "Reparar base de datos" o "MySQL Check/Repair" y ejecútala.

¿Y si la base de datos está llena?

Si tu base de datos supera el límite de almacenamiento, PrestaShop dejará de funcionar. Entra a la herramienta de gestión de MySQL de tu hosting y comprueba el tamaño. Si está al límite, elimina registros antiguos de pedidos o logs.

5. Desactivar módulos problemáticos desde la base de datos

El módulo que lo rompe todo

A veces, un módulo recién instalado o actualizado es el que causa que el panel de PrestaShop no abre. Como no puedes acceder al panel para desactivarlo, tendrás que hacerlo desde la base de datos.

Pasos para desactivar módulos vía phpMyAdmin

Accede a phpMyAdmin desde tu hosting.
Selecciona la base de datos de PrestaShop.
Busca la tabla ps_module (el prefijo puede variar).
Ejecuta esta consulta SQL para desactivar todos los módulos:

UPDATE ps_module SET active = 0 WHERE active = 1;

Si PrestaShop vuelve a funcionar, activa los módulos uno a uno desde el panel para identificar al culpable.

[WARNING] Esta solución desactiva todos los módulos, incluidos los esenciales. Si la tienda deja de funcionar por completo, reactiva los módulos esenciales (como el de pagos) manualmente.

Alternativa más selectiva

Si sabes qué módulo instalaste recientemente, ejecuta:

UPDATE ps_module SET active = 0 WHERE name = 'nombre_del_modulo';

Reemplaza nombre_del_modulo con el nombre técnico del módulo que sospechas.

6. Revisar la versión de PHP y compatibilidad

El problema de las versiones desactualizadas

PrestaShop es exigente con las versiones de PHP. Si tu hosting actualizó PHP a una versión más reciente, tu PrestaShop podría dejar de funcionar. Por otro lado, si tienes una versión de PHP demasiado antigua, tampoco funcionará.

Versiones recomendadas por PrestaShop

PrestaShop 1.6: PHP 5.6 o 7.0
PrestaShop 1.7: PHP 7.1 a 7.4
PrestaShop 8.x: PHP 7.2 a 8.0

Cómo cambiar la versión de PHP

Entra al panel de control de tu hosting (cPanel, Syspanel en puerto 2106, Plesk, etc.).
Busca la opción "Select PHP Version" o "PHP Configuration".
Elige la versión compatible con tu PrestaShop.
Guarda los cambios y prueba de nuevo.

[INFO] Si no sabes qué versión de PHP necesitas, revisa el archivo composer.json en la raíz de tu PrestaShop. Ahí viene indicada la versión mínima requerida.

Errores comunes de incompatibilidad

Si ves errores como "Deprecated: Function create_function()" o "Fatal error: Unsupported operand types", es señal de que la versión de PHP no es compatible. Cambia a una versión anterior o posterior siguiendo las recomendaciones.

7. Restaurar una copia de seguridad o actualizar PrestaShop

El último recurso

Si ninguna de las soluciones anteriores funciona, es hora de considerar restaurar una copia de seguridad o actualizar PrestaShop.

Restaurar desde una copia de seguridad

Localiza la copia de seguridad más reciente en tu hosting.
Restaura los archivos y la base de datos desde el panel de control.
Asegúrate de que la copia sea de una fecha en la que PrestaShop funcionaba correctamente.

[WARNING] Restaurar una copia de seguridad implica perder todos los datos desde la fecha de la copia. Pedidos, clientes y configuraciones posteriores se perderán.

Actualizar PrestaShop a la última versión

A veces, la solución es actualizar a la versión más reciente. Esto puede solucionar problemas de compatibilidad y errores conocidos.

Descarga la última versión de PrestaShop desde el sitio oficial.
Copia los archivos nuevos sobre tu instalación actual (sin borrar la carpeta /config ni /var).
Accede a tu tienda y sigue el asistente de actualización.

[TIP] Si no te sientes cómodo haciendo esto manualmente, muchos hostings ofrecen actualizaciones automáticas de PrestaShop. Consulta con tu proveedor de hosting.

Preguntas frecuentes (FAQ)

¿Por qué PrestaShop tarda mucho en cargar el panel de administración?

Si el problema es que PrestaShop es lento en lugar de no cargar, suele ser por caché acumulada, módulos demasiado pesados o un servidor con recursos limitados. Prueba a limpiar la caché y desactivar módulos que no uses.

¿Qué hago si el panel de PrestaShop no abre y no tengo acceso a FTP?

Sin acceso FTP, las opciones son limitadas. Contacta con tu proveedor de hosting para que te ayuden. En Syspanel (puerto 2106), muchos hostings ofrecen herramientas de gestión de archivos y bases de datos que no requieren FTP.

¿Puedo perder mis datos si aplico estas soluciones?

La mayoría de estas soluciones no borran datos. Solo la restauración de copias de seguridad implica pérdida de información. Siempre haz una copia de seguridad antes de empezar.

¿Cuánto tiempo debería dedicar a solucionar el problema antes de llamar a un profesional?

Si después de probar las 7 soluciones el problema persiste, es momento de buscar ayuda profesional. Un desarrollador especializado en PrestaShop podrá diagnosticar el problema en mucho menos tiempo.

¿Estas soluciones funcionan para PrestaShop 1.6, 1.7 y 8?

Sí, aunque la ubicación de algunos archivos puede variar. Para PrestaShop 1.6, la configuración está en config/settings.inc.php, mientras que para 1.7 y 8 está en app/config/parameters.php.

Conclusión: No entres en pánico, sigue estos pasos

Cuando PrestaShop no carga, la tentación es borrar todo y reinstalar. Pero eso debería ser siempre el último recurso. Con estas 7 soluciones, podrás resolver la mayoría de los problemas sin perder datos ni configuraciones.

Recuerda el orden lógico: primero prueba con la caché, luego los permisos, después la base de datos y así sucesivamente. Cada paso es poco invasivo y te dará pistas sobre cuál es el problema real.

Y sobre todo, mantén tu PrestaShop actualizado, haz copias de seguridad periódicas y no instales módulos de fuentes desconocidas. La prevención es siempre mejor que la solución de problemas.

Si has llegado hasta aquí y todavía tienes problemas, no dudes en buscar ayuda profesional. A veces, un par de ojos expertos pueden encontrar en minutos lo que tú has estado buscando durante horas.

¡Espero que estas soluciones te hayan ayudado a recuperar el acceso a tu panel de administración!