Solucionar errores de PrestaShop en Syspanel | FAQ y guía

Si estás gestionando una tienda online con PrestaShop y utilizas Syspanel (anteriormente conocido como HestiaCP), es probable que en algún momento te encuentres con algún error. No te preocupes, es algo habitual. En este artículo vamos a repasar los errores más comunes de PrestaShop en Syspanel y, lo más importante, cómo solucionarlos paso a paso. Todo explicado de forma sencilla, sin tecnicismos complicados.

¿Por qué aparecen errores en PrestaShop con Syspanel?

PrestaShop es un software potente, pero necesita ciertos requisitos del servidor para funcionar correctamente. Syspanel, como panel de control, gestiona el servidor y los sitios web, pero a veces la configuración no es la ideal para PrestaShop. Los errores más frecuentes suelen estar relacionados con la memoria, los permisos de archivos, la versión de PHP o la base de datos.

A continuación, te mostramos los fallos más típicos y cómo resolverlos tú mismo, sin necesidad de ser un experto.

Error 500 en PrestaShop desde Syspanel

El PrestaShop error 500 Syspanel es, sin duda, uno de los más comunes. Este error significa que algo falla en el servidor, pero no da muchos detalles. Puede deberse a varias causas.

Causas más frecuentes del error 500

PHP con memoria insuficiente (límite de memory_limit bajo).
Archivos con permisos incorrectos (por ejemplo, después de una actualización).
Módulo o tema incompatible que rompe la tienda.
Errores en el archivo .htaccess (por reglas de reescritura mal configuradas).

Cómo solucionar el error 500 paso a paso

Accede a Syspanel (puerto 2106) con tu usuario y contraseña.
Ve a la sección "PHP" o "Configuración de PHP" (dependiendo de la versión de Syspanel).
Busca la opción "memory_limit" y cámbiala a un valor mínimo de 256M (o incluso 512M si tu tienda tiene muchos productos).
Guarda los cambios y reinicia el servicio PHP desde el mismo panel (suele haber un botón "Reiniciar PHP" o "Restart").
Si el error persiste, revisa los logs de error en Syspanel. Normalmente están en "Logs" o "Registros". Busca la línea que indique el error concreto.
Prueba a renombrar el archivo .htaccess (cambiándolo a .htaccess_old) desde el gestor de archivos de Syspanel. Si la tienda vuelve a funcionar, el problema está en ese archivo. Puedes regenerarlo desde el backoffice de PrestaShop (Parámetros de la tienda > Tráfico y SEO > URL amigables, y guardar de nuevo).
Si todo falla, desactiva temporalmente los módulos desde el gestor de archivos: renombra la carpeta /modules a /modules_old. Si la tienda carga, el conflicto está en algún módulo. Ve activándolos uno a uno para localizar el culpable.

[TIP] Siempre que hagas cambios en Syspanel, espera unos segundos y limpia la caché de tu navegador antes de recargar la tienda.

Error de memoria insuficiente (Allowed memory size exhausted)

Este error es muy habitual en tiendas con muchos productos o módulos pesados. Aparece un mensaje como: "Allowed memory size of 134217728 bytes exhausted".

Solución en Syspanel

Entra en Syspanel (puerto 2106) y ve a "PHP Settings" o "Editar PHP" para el dominio de tu tienda.
Aumenta los siguientes valores recomendados para PrestaShop:
- memory_limit: 256M o 512M
- max_execution_time: 120 (segundos)
- max_input_vars: 5000 (especialmente importante si tienes muchos atributos o combinaciones)
Guarda y reinicia PHP.
Si el error sigue, comprueba que tu plan de hosting tenga suficiente RAM. En Syspanel puedes ver el uso de recursos en la sección "Estadísticas".

Error de conexión a la base de datos

Otro clásico. La tienda deja de cargar y muestra algo como: "Cannot connect to database" o "Error de conexión a la base de datos".

Causas y soluciones

Credenciales incorrectas: Verifica en el archivo app/config/parameters.php de tu PrestaShop (dentro de la carpeta de la tienda) que el nombre de la base de datos, usuario y contraseña coincidan con los que tienes en Syspanel.
Base de datos caída: En Syspanel, ve a "Base de datos" y comprueba que el servicio MySQL/MariaDB esté activo. Si no lo está, reinícialo desde el botón correspondiente.
Espacio en disco lleno: Revisa en Syspanel la sección "Uso de disco". Si está al 100%, la base de datos no puede escribir. Libera espacio eliminando logs antiguos o backups innecesarios.

[WARNING] No edites el archivo parameters.php directamente si no sabes lo que haces. Haz siempre una copia de seguridad antes.

Error de permisos en archivos y carpetas

Después de una actualización o al instalar un módulo, PrestaShop puede mostrar errores de permisos. La tienda se ve rara, no se suben imágenes o salen avisos de "no se puede escribir".

Cómo arreglarlo desde Syspanel

En Syspanel, ve al "Gestor de archivos" (o "File Manager").
Navega hasta la carpeta raíz de tu tienda PrestaShop.
Selecciona todos los archivos y carpetas (puedes marcar la casilla superior).
Busca la opción "Permisos" o "CHMOD".
Establece los siguientes permisos:
- Carpetas: 755
- Archivos: 644
- Carpetas especiales (img, upload, cache, log, config, download, etc.): 755
Aplica los cambios. Si hay muchas subcarpetas, activa la opción "Recursivo" (aplicar a subdirectorios).
También puedes usar la herramienta de "Reparar permisos" que algunos paneles Syspanel incluyen en la sección de PrestaShop.

Error de versión de PHP no compatible

PrestaShop necesita una versión de PHP concreta. Por ejemplo, PrestaShop 1.7 funciona bien con PHP 7.4 u 8.0, pero no con PHP 8.2 o superior. Si la versión no es la correcta, la tienda dará error o no se abrirá.

Solución en Syspanel

Ve a "PHP Settings" para tu dominio en Syspanel.
Cambia la versión de PHP a una compatible con tu PrestaShop. Consulta la documentación de tu versión de PrestaShop para saber cuál es la recomendada.
Guarda y reinicia PHP.
Si tienes varias versiones instaladas, asegúrate de que la extensión "ionCube" o "SourceGuardian" esté activa si tu tienda usa módulos comerciales.

[INFO] Para PrestaShop 1.6, usa PHP 5.6 o 7.0. Para PrestaShop 1.7, PHP 7.4 es la opción más estable. PrestaShop 8.x funciona con PHP 8.1 o 8.2.

Error de módulo o tema que bloquea la tienda

A veces, al instalar un módulo o cambiar de tema, la tienda deja de funcionar. Puede aparecer un error 500 o una página en blanco.

Cómo solucionarlo sin perder datos

Accede al gestor de archivos de Syspanel.
Ve a la carpeta /modules de tu PrestaShop.
Localiza la carpeta del módulo problemático (si sabes cuál es) y renómbrala (por ejemplo, añadiendo "_old" al final).
Si no sabes cuál es, renombra la carpeta /themes (por ejemplo, a /themes_old). La tienda cargará con el tema por defecto.
Una vez localizado el problema, desde el backoffice de PrestaShop puedes desinstalar o actualizar el módulo o tema conflictivo.

Preguntas frecuentes (FAQ) sobre errores PrestaShop Syspanel

¿Dónde veo los logs de error en Syspanel?

En Syspanel, busca la sección "Logs" o "Registros". Allí encontrarás los logs de acceso y de error del servidor. También puedes ver los logs de PHP en "PHP Settings" > "Logs de error". Los errores de PrestaShop suelen aparecer en el archivo error.log dentro de la carpeta de tu tienda.

¿Cómo reinicio PHP en Syspanel?

Ve a "PHP Settings" de tu dominio y busca el botón "Reiniciar PHP" o "Restart PHP-FPM". También puedes reiniciar desde la sección "Servicios" del panel.

¿Qué hago si no puedo acceder al backoffice de PrestaShop?

Prueba a forzar el acceso manual: añade /admin (o la carpeta de administración que tengas) a la URL de tu tienda. Si no funciona, revisa los logs de error. Otra opción es desactivar módulos desde el gestor de archivos como explicamos antes.

¿Es seguro aumentar la memoria PHP en Syspanel?

Sí, siempre que no superes los límites de tu plan de hosting. Syspanel te permite ajustar estos valores. Si pones un valor muy alto y tu servidor no tiene suficiente RAM, la tienda puede ir lenta. Lo recomendado para PrestaShop es 256M.

¿Puedo restaurar una copia de seguridad desde Syspanel?

Sí, en Syspanel tienes la sección "Backups". Puedes restaurar copias completas del sitio o solo de la base de datos. Es muy útil si un error grave deja la tienda inservible.

Consejos finales para evitar errores PrestaShop Syspanel

Mantén PrestaShop actualizado a la última versión estable.
Usa siempre módulos y temas de fuentes fiables.
Haz copias de seguridad periódicas desde Syspanel (al menos una vez por semana).
Revisa los logs cada cierto tiempo para detectar problemas antes de que se conviertan en errores graves.
No instales demasiados módulos innecesarios; ralentizan la tienda y aumentan los conflictos.

Recuerda que Syspanel (puerto 2106) es una herramienta muy potente para gestionar tu hosting. Con estos trucos podrás solucionar la mayoría de los errores PrestaShop Syspanel por ti mismo. Si el problema persiste, no dudes en contactar con el soporte técnico de tu proveedor de hosting, indicando los pasos que ya has probado.

Esperamos que esta guía te haya sido de ayuda. ¡Tu tienda online volverá a funcionar en pocos minutos!