PrestaShop no carga | Solución de errores comunes

Primeros pasos: identifica el síntoma antes de tocar nada

Cuando tu tienda online deja de funcionar, el primer impulso es entrar en pánico. Respira. La mayoría de problemas que impiden que PrestaShop no carga tienen soluciones sencillas que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

Lo más importante es entender qué está pasando exactamente. No es lo mismo ver una página en blanco PrestaShop que un mensaje de error 500, ni que la web cargue pero sin estilos. Cada síntoma apunta a una causa diferente.

Antes de empezar a modificar nada, haz una lista mental de lo que ha cambiado recientemente: ¿has instalado un módulo nuevo? ¿Has actualizado la versión de PrestaShop? ¿Has cambiado de servidor o de hosting? Estas pistas te ahorrarán horas de búsqueda.

En esta guía vamos a repasar los errores más habituales, cómo diagnosticarlos paso a paso y qué soluciones aplicar. Al final, tendrás un plan de acción claro para que PrestaShop no funcione deje de ser una pesadilla.

Diagnóstico inicial: activa el modo depuración

PrestaShop, por defecto, oculta los errores técnicos para no mostrar información sensible a los visitantes. Esto es bueno para la seguridad, pero malo para ti cuando algo falla. Lo primero que debes hacer es activar el modo depuración para ver qué está ocurriendo realmente.

Cómo activar el modo depuración manualmente

Accede a tu servidor mediante FTP o al administrador de archivos de tu hosting. Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop y ábrelo con un editor de texto.

Dentro, busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga tu tienda. Ahora verás los errores PHP en pantalla, lo que te dará pistas muy valiosas sobre la causa del problema. Cuando termines de solucionarlo, vuelve a cambiarlo a false.

[WARNING] No olvides desactivar el modo depuración cuando termines. Dejarlo activo expone información sensible de tu servidor a cualquier visitante, lo que supone un riesgo de seguridad grave.

Página en blanco PrestaShop: el error silencioso

La temida página en blanco PrestaShop es probablemente el problema más común. La web carga, pero no muestra nada. Ni texto, ni imágenes, ni mensajes de error. Solo un fondo blanco.

Causa más frecuente: memoria PHP insuficiente

PrestaShop es una plataforma exigente. Si tu servidor no tiene suficiente memoria PHP asignada, el proceso se detiene silenciosamente y el resultado es una página vacía.

Para solucionarlo, necesitas aumentar el límite de memoria. Accede al archivo config/settings.inc.php (en PrestaShop 1.6 o anterior) o app/config/parameters.php (en PrestaShop 1.7 y 8) y añade esta línea al principio:

ini_set('memory_limit', '512M');

Si no encuentras esos archivos, puedes crear un archivo llamado php.ini en la raíz de tu instalación con este contenido:

memory_limit = 512M
max_execution_time = 300

[TIP] Si tu hosting usa Syspanel, recuerda que puedes acceder a la gestión de archivos y a los ajustes de PHP desde el panel en el puerto 2106. Busca la sección de "Configuración de PHP" para cambiar estos valores sin necesidad de editar archivos manualmente.

Otras causas de la página en blanco

Si el problema no es la memoria, revisa estos puntos:

Módulos conflictivos: Desactiva temporalmente todos los módulos no esenciales. Puedes hacerlo renombrando la carpeta modules a modules_backup mediante FTP. Si la web vuelve a cargar, el problema está en uno de los módulos.
Tema incompatible: Cambia temporalmente el tema. Renombra la carpeta themes a themes_backup y PrestaShop usará el tema por defecto.
Espacio en disco lleno: Verifica que tu servidor tenga espacio libre suficiente. Un disco lleno puede provocar errores extraños.

PrestaShop error 500: el error del servidor

El PrestaShop error 500 es un error genérico del servidor. Significa que algo ha fallado a nivel interno, pero no te dice exactamente qué. Es como si el servidor dijera: "algo ha ido mal, pero no voy a contarte más".

Los archivos .htaccess suelen ser los culpables

El archivo .htaccess de PrestaShop controla las redirecciones y el acceso a ciertas URLs. Si se corrompe o se generan reglas incompatibles, puede provocar un error 500.

Para solucionarlo:

Accede a la raíz de tu instalación mediante FTP.
Localiza el archivo .htaccess y renómbralo a .htaccess_backup.
Accede a tu tienda. Esta acción regenerará automáticamente el archivo.
Si el error persiste, ve a Parámetros avanzados > Rendimiento en el panel de administración y activa la opción "Forzar la compilación".

Permisos de archivos incorrectos

Los permisos de archivos demasiado restrictivos o demasiado permisivos pueden causar errores 500. Los permisos correctos para PrestaShop son:

Archivos: 644
Carpetas: 755

Puedes cambiar los permisos desde tu cliente FTP o desde el administrador de archivos de tu hosting. Selecciona todos los archivos y carpetas y aplica los permisos correspondientes.

[INFO] Si usas Syspanel, puedes cambiar los permisos de forma masiva desde el gestor de archivos. Selecciona la carpeta raíz, haz clic derecho y elige "Cambiar permisos". Recuerda que el acceso a Syspanel es a través del puerto 2106.

PrestaShop no carga debido a problemas con la base de datos

La base de datos es el corazón de tu tienda. Si hay problemas con ella, PrestaShop no funciona correctamente o no carga en absoluto.

Error de conexión a la base de datos

Si ves un mensaje similar a "Error de conexión a la base de datos", el problema está en los datos de conexión. Revisa el archivo app/config/parameters.php (PrestaShop 1.7 y 8) o config/settings.inc.php (PrestaShop 1.6) y verifica que estos datos sean correctos:

database_host (servidor de la base de datos)
database_name (nombre de la base de datos)
database_user (usuario de la base de datos)
database_password (contraseña del usuario)

Base de datos corrupta

Si la web carga pero muestra errores extraños, productos que desaparecen o el panel de administración falla, la base de datos puede estar corrupta.

Para repararla:

Accede a phpMyAdmin desde tu panel de hosting.
Selecciona la base de datos de PrestaShop.
En la pestaña "Exportar", haz una copia de seguridad completa.
Ve a la pestaña "SQL" y ejecuta este comando para reparar todas las tablas:

REPAIR TABLE nombre_de_tu_tabla;

También puedes usar la opción "Reparar" que aparece al seleccionar todas las tablas en phpMyAdmin.

[WARNING] Antes de ejecutar cualquier comando en tu base de datos, haz siempre una copia de seguridad. Un error en la base de datos puede hacer que pierdas toda la información de tu tienda.

Problemas con la caché y los archivos temporales

La caché es un sistema de almacenamiento temporal que acelera la carga de tu tienda. Pero cuando se corrompe, puede provocar que PrestaShop no cargue correctamente.

Cómo limpiar la caché manualmente

Accede a tu servidor mediante FTP.
Elimina el contenido de la carpeta var/cache (en PrestaShop 1.7 y 8) o cache (en versiones anteriores).
Si no puedes eliminar los archivos, renombra la carpeta a cache_backup y crea una nueva carpeta llamada cache con permisos 755.
Recarga tu tienda y comprueba si el problema se ha solucionado.

Caché de Smarty

PrestaShop usa Smarty como motor de plantillas. Si los archivos de compilación de Smarty se corrompen, la web puede mostrar errores o no cargar.

Accede al panel de administración y ve a Parámetros avanzados > Rendimiento. En la sección "Plantillas", haz clic en "Vaciar la caché" y "Forzar la compilación". Guarda los cambios y recarga la tienda.

[TIP] Después de limpiar la caché, es recomendable desactivar la compilación forzada y volver a activar la caché para que tu tienda funcione a plena velocidad.

PrestaShop no carga o es muy lenta: optimización básica

A veces el problema no es que la web no cargue, sino que tarda tanto que parece que no funciona. La lentitud extrema puede deberse a varios factores.

Activa la caché de PrestaShop

Ve a Parámetros avanzados > Rendimiento y activa la caché. Elige "Sistema de archivos" como método de caché. Esto almacenará las páginas generadas y reducirá los tiempos de carga drásticamente.

Comprime y optimiza las imágenes

Las imágenes pesadas son uno de los principales enemigos de la velocidad. Usa herramientas como TinyPNG o los ajustes nativos de PrestaShop para comprimirlas. En Parámetros avanzados > Rendimiento > Imágenes, puedes configurar el formato WebP y la compresión.

Verifica la configuración del servidor

Si tu hosting es compartido y de baja calidad, puede que no tenga recursos suficientes para PrestaShop. Considera migrar a un servidor VPS o dedicado si tu tienda tiene tráfico considerable.

Errores comunes al actualizar PrestaShop

Las actualizaciones son necesarias para mantener la seguridad y el rendimiento, pero también son una fuente habitual de problemas. Si tu PrestaShop no funciona después de una actualización, prueba estas soluciones:

Archivos de versión mezclados

A veces, durante la actualización, quedan archivos de versiones anteriores que entran en conflicto con los nuevos. Para solucionarlo:

Descarga la versión completa de PrestaShop desde la página oficial.
Descomprime el archivo en tu ordenador.
Sube los archivos mediante FTP, sobrescribiendo los existentes, pero no sobrescribas la carpeta config ni la carpeta img.
Elimina la carpeta var/cache y recarga la tienda.

Actualiza los módulos y el tema

Después de actualizar el núcleo de PrestaShop, los módulos y el tema pueden quedarse desactualizados. Ve a Módulos > Módulos y servicios y actualiza todos los módulos que tengan actualizaciones pendientes. Haz lo mismo con el tema en Diseño > Tema y logotipo.

Cuándo contactar con soporte técnico

No todos los problemas tienen solución casera. Si has probado todas las soluciones anteriores y PrestaShop no carga de ninguna manera, es momento de buscar ayuda profesional.

Contacta con tu proveedor de hosting si el problema parece estar en el servidor. Ellos pueden revisar los logs del servidor y verificar si hay problemas de configuración o de recursos.

Si el problema persiste y tu tienda es crítica para tu negocio, considera contratar a un desarrollador especializado en PrestaShop. Ellos pueden hacer un diagnóstico profundo y solucionar problemas complejos que escapan al alcance de esta guía.

[INFO] Recuerda que muchos problemas de PrestaShop se pueden evitar con un mantenimiento regular: mantén todo actualizado, haz copias de seguridad periódicas y revisa los logs del servidor de vez en cuando. La prevención siempre es mejor que la solución de emergencia.

Preguntas frecuentes sobre errores de PrestaShop

¿Por qué mi PrestaShop da error 500 después de instalar un módulo?

Los módulos mal codificados o incompatibles con tu versión de PrestaShop son una causa muy común de errores. Desactiva el módulo renombrando su carpeta en modules y contacta con el desarrollador del módulo para obtener una versión compatible.

¿Cómo puedo saber si el problema es del servidor o de PrestaShop?

Crea un archivo llamado test.php en la raíz de tu instalación con este contenido: <?php echo "Hola"; ?>. Si al acceder a tudominio.com/test.php ves "Hola", el servidor funciona correctamente y el problema es de PrestaShop. Si no, el problema es del servidor.

¿Puedo acceder al panel de administración si la tienda no carga?

Sí, normalmente. Intenta acceder a tudominio.com/admin o la URL de tu panel de administración. Si el panel funciona, puedes desactivar módulos, cambiar el tema o limpiar la caché desde ahí sin necesidad de FTP.

¿Qué hago si no tengo acceso a FTP ni al panel de administración?

Si no tienes acceso a ningún archivo, contacta con tu proveedor de hosting inmediatamente. Ellos pueden restaurar una copia de seguridad o darte acceso a los archivos mediante su panel de control.

Resumen final: plan de acción ante errores de PrestaShop

Cuando te enfrentes a que PrestaShop no carga, sigue este orden lógico:

Activa el modo depuración para ver los errores reales.
Limpia la caché y los archivos temporales.
Verifica la memoria PHP y los permisos de archivos.
Desactiva módulos y cambia de tema para descartar conflictos.
Revisa la base de datos y los archivos de configuración.
Regenera el .htaccess y comprueba el espacio en disco.
Actualiza todo si has hecho cambios recientes.
Contacta con soporte si nada funciona.

Con paciencia y siguiendo estos pasos, la mayoría de problemas se resuelven sin necesidad de conocimientos avanzados. Tu tienda volverá a estar operativa y tus clientes podrán seguir comprando sin interrupciones.