PrestaShop no carga en Syspanel | Diagnóstico y arreglo

¿Tu tienda PrestaShop se ha quedado congelada, no carga o ves una pantalla en blanco? Es una situación frustrante, sobre todo si tienes clientes intentando comprar. No te preocupes, como técnico de soporte, te guiaré paso a paso para que puedas diagnosticar y solucionar el problema desde tu panel de control Syspanel (accesible en tu navegador escribiendo tudominio.com:2106). Vamos a desglosar las causas más comunes y sus soluciones, escritas para que cualquiera pueda seguirlas.

¿Por qué PrestaShop no carga? Causas más frecuentes

Cuando PrestaShop deja de cargar, suele deberse a uno de estos motivos:

Error de memoria PHP (límite de memoria excedido): PrestaShop necesita un mínimo de memoria para funcionar. Si tu tienda tiene muchos módulos, imágenes o tráfico, puede agotar el límite.
Pantalla blanca (WSOD - White Screen of Death): Es el síntoma más común. Ocurre por un error crítico de PHP, un módulo incompatible o una modificación incorrecta en un archivo.
Problemas de permisos de archivos: Los archivos y carpetas de PrestaShop necesitan permisos específicos para que el servidor pueda leerlos y escribirlos.
Versión de PHP incorrecta: PrestaShop es exigente con la versión de PHP. Usar una versión antigua o demasiado nueva puede romper la tienda.
Error en el archivo .htaccess: Este archivo controla las reglas de reescritura de URLs. Si está dañado, las páginas no cargarán correctamente.
Base de datos corrupta o con errores: Una tabla de la base de datos puede estar dañada, impidiendo que PrestaShop se conecte.
Módulo o tema defectuoso: A veces, una actualización o instalación de un módulo o tema causa un conflicto.

Vamos a ver cómo solucionar cada una desde Syspanel.

Soluciones paso a paso desde Syspanel

Syspanel (tu dominio:2106) es la herramienta que te permite gestionar tu servidor. No te asustes, es más sencillo de lo que parece. Aquí tienes las soluciones ordenadas de la más fácil a la más avanzada.

1. Aumentar el límite de memoria PHP (La solución más común)

Este es el primer lugar donde mirar. Si PrestaShop no carga y ves un error como "Allowed memory size of X bytes exhausted", sigue estos pasos:

Accede a Syspanel: Abre tu navegador y escribe tudominio.com:2106. Inicia sesión con tu usuario y contraseña.
Ve a Configuración del servidor: Busca en el menú lateral izquierdo la opción "Configuración del servidor" o "Server Settings".
Selecciona "PHP" o "Configuración PHP": Dentro de esa sección, verás una pestaña dedicada a PHP.
Busca "memory_limit": En la lista de parámetros, localiza memory_limit. Por defecto suele estar en 128M o 256M.
Auméntalo: Cámbialo a 512M o incluso 1024M (1GB) si tu servidor tiene suficiente RAM. En la casilla, escribe el valor (por ejemplo, 512M).
Guarda los cambios: Haz clic en el botón "Guardar" o "Save". Luego, reinicia el servicio PHP (normalmente hay un botón de "Reiniciar PHP" o "Restart PHP-FPM").

[TIP] Si no encuentras la opción exacta, busca "PHP-FPM" o "PHP Settings" en el menú. Syspanel organiza todo de forma muy visual.

2. Activar el modo debug para ver el error (Pantalla blanca)

Si ves una pantalla blanca (PrestaShop pantalla blanca) sin ningún mensaje, es porque los errores están ocultos. Activar el modo debug te mostrará el error real.

Conéctate por FTP o al administrador de archivos de Syspanel: En Syspanel, busca "Administrador de archivos" o "File Manager". Navega hasta la carpeta donde está instalado PrestaShop (normalmente public_html o dominio.com).
Localiza el archivo config/defines.inc.php: Dentro de la carpeta config, busca el archivo defines.inc.php.
Edítalo: Haz clic derecho y selecciona "Editar" o "Edit".
Busca la línea: Busca define('_PS_MODE_DEV_', false);
Cámbiala: Modifícala por: define('_PS_MODE_DEV_', true);
Guarda el archivo: Guarda los cambios (Ctrl+S o el botón de guardar).
Recarga tu tienda: Ahora, en lugar de la pantalla blanca, verás un mensaje de error detallado (por ejemplo, "Fatal error: Uncaught Error: Class 'MóduloX' not found"). Ese mensaje te dirá exactamente qué módulo o archivo está fallando.
Solución típica: Si el error menciona un módulo, puedes deshabilitarlo desde la base de datos o renombrar su carpeta (más adelante te explico cómo).

[WARNING] No dejes el modo debug activado en producción. Una vez solucionado, vuelve a poner false. Esto evita que los usuarios vean errores internos.

3. Deshabilitar un módulo problemático desde la base de datos

Si el error te indica un módulo específico (por ejemplo, "Error en el módulo 'supermodulo'"), puedes deshabilitarlo directamente desde la base de datos sin necesidad de entrar al panel de administración.

Accede a phpMyAdmin desde Syspanel: En el menú de Syspanel, busca "Bases de datos" o "Databases" y luego haz clic en "phpMyAdmin".
Selecciona tu base de datos: En el panel izquierdo, elige la base de datos de tu PrestaShop (suele tener un nombre como tu_usuario_prestashop).
Busca la tabla ps_module: En la lista de tablas, busca la tabla que empieza por ps_module (el prefijo puede variar si lo cambiaste, por defecto es ps_).
Busca el módulo problemático: Haz clic en la tabla ps_module y luego en la pestaña "Buscar" o "Search". Introduce el nombre del módulo que falla.
Deshabilítalo: Una vez localizado, haz clic en "Editar" (el icono de lápiz). Busca la columna active y cambia el valor de 1 a 0.
Guarda: Haz clic en "Continuar" o "Go".
Recarga tu tienda: Ahora PrestaShop debería cargar sin ese módulo.

4. Verificar y corregir permisos de archivos

Los permisos incorrectos son otra causa común de PrestaShop no carga Syspanel. Los archivos deben tener permisos 644 y las carpetas 755.

Ve al administrador de archivos de Syspanel: Navega hasta la raíz de tu PrestaShop (carpeta public_html).
Selecciona todo: Marca la casilla de la carpeta raíz (la que contiene index.php, config, modules, etc.).
Cambia permisos: Busca el botón "Permisos" o "Permissions" (suele ser un icono de candado).
Aplica los valores correctos:
- En "Permisos de archivos" escribe 644.
- En "Permisos de directorios" escribe 755.
Aplica recursivamente: Asegúrate de marcar la opción "Aplicar a subdirectorios" o "Recursively".
Haz clic en "Aceptar" o "OK".

5. Regenerar el archivo .htaccess

Si tu tienda carga la página de inicio pero las demás páginas dan error 404 o no cargan, el .htaccess puede estar dañado.

Conéctate por FTP o al administrador de archivos.
Localiza el archivo .htaccess: Está en la raíz de PrestaShop. Si no lo ves, activa la opción "Mostrar archivos ocultos" en el administrador de archivos.
Renómbralo: Cámbiale el nombre a .htaccess_old (por si acaso).
Ve al panel de administración de PrestaShop: Accede a tudominio.com/admin (o la URL de tu back office).
Regenera el .htaccess: Ve a "Parámetros de la tienda" > "Tráfico y SEO" > "SEO y URLs". En la parte inferior, haz clic en "Guardar" (sin cambiar nada). Esto regenerará el archivo automáticamente.

[INFO] Si no puedes acceder al back office, desde Syspanel puedes crear un archivo .htaccess vacío y luego forzar la regeneración desde la base de datos (es más avanzado, prueba primero los pasos anteriores).

6. Cambiar la versión de PHP

PrestaShop 1.7 y 8.x funcionan mejor con PHP 7.4 o 8.0/8.1. Si tu versión es muy antigua (PHP 5.6) o muy nueva (PHP 8.2+), puede dar errores.

En Syspanel, ve a "Configuración del servidor" > "PHP".
Busca "Versión de PHP" o "PHP Version": Verás un menú desplegable.
Selecciona una versión compatible: Para PrestaShop 1.7, elige 7.4 o 8.0. Para PrestaShop 8, elige 8.1.
Guarda y reinicia PHP.

7. Reparar la base de datos

Una base de datos corrupta puede causar que PrestaShop no cargue o que muestre errores de conexión.

Ve a phpMyAdmin desde Syspanel.
Selecciona tu base de datos.
Marca todas las tablas: En la parte inferior, haz clic en "Marcar todo" o "Check All".
Selecciona "Reparar tabla" o "Repair table" en el menú desplegable de acciones.
Ejecuta la reparación: Esto revisará y corregirá cualquier error en las tablas.

FAQ: Preguntas frecuentes sobre PrestaShop que no carga

P: ¿Qué hago si después de todo sigue sin cargar?
R: A veces un plugin de seguridad (como un firewall) bloquea la conexión. Revisa en Syspanel si tienes algún firewall activo (como Fail2ban) y desactívalo temporalmente para probar. También verifica los logs de error de PHP en Syspanel (busca "Logs" o "Error Logs") para pistas adicionales.

P: ¿Puedo perder datos si aumento el límite de memoria?
R: No, es un cambio seguro que solo afecta a la memoria disponible para ejecutar scripts. No toca tus productos, clientes ni pedidos.

P: Mi PrestaShop da error 500, ¿qué significa?
R: Un error 500 es un error interno del servidor. Generalmente está relacionado con un error PHP PrestaShop (como un módulo roto) o permisos de archivos. Sigue los pasos 2 (modo debug) y 4 (permisos).

P: ¿Cómo sé si el problema es del hosting o de mi tienda?
R: Si otras webs en tu mismo servidor funcionan bien, el problema es de tu PrestaShop. Si todas fallan, contacta a tu proveedor de hosting. Syspanel te permite ver el estado del servidor (CPU, RAM) para diagnosticar.

P: ¿Debo actualizar PrestaShop a la última versión?
R: Sí, siempre que sea posible. Las versiones antiguas tienen bugs y vulnerabilidades. Pero antes de actualizar, haz una copia de seguridad de archivos y base de datos desde Syspanel (busca "Backup").

Resumen rápido para no perder la calma

Aumenta el límite de memoria PHP a 512M (es lo que más soluciona).
Activa el modo debug para ver el error exacto.
Deshabilita módulos problemáticos desde phpMyAdmin.
Corrige permisos de archivos (644/755).
Regenera el .htaccess desde el back office.

Si después de todo esto tu PrestaShop no carga, no dudes en escribirnos. Como técnico de soporte, estamos aquí para ayudarte a que tu tienda vuelva a funcionar lo antes posible. ¡Recuerda, siempre desde Syspanel (puerto 2106) tienes el control!