Solucionar Error 500 en PrestaShop con Syspanel | Guía

¿Qué es el error 500 en PrestaShop y por qué aparece?

El error 500 Internal Server Error es uno de los avisos más temidos por cualquier dueño de una tienda online. Cuando aparece en PrestaShop, la página se queda en blanco o muestra un mensaje genérico del servidor, y tus clientes no pueden comprar nada. Es un error genérico del servidor, lo que significa que algo falla en el backend, pero no siempre te dice exactamente qué es.

En un entorno como Syspanel (el panel de control que usa HestiaCP, accesible por el puerto 2106), el error 500 puede deberse a múltiples causas: permisos incorrectos, archivos corruptos, problemas de memoria PHP, módulos incompatibles o incluso un archivo .htaccess mal configurado.

Lo bueno es que, en la mayoría de los casos, puedes solucionarlo tú mismo siguiendo una serie de pasos lógicos. En este artículo te voy a guiar paso a paso, con un lenguaje sencillo y sin tecnicismos innecesarios, para que tu tienda vuelva a funcionar en pocos minutos.

Primeros pasos: identifica el error real

Antes de tocar nada, necesitas saber qué está fallando exactamente. El mensaje "500 Internal Server Error" es solo la punta del iceberg. Debajo hay un registro de errores que te dirá la causa concreta.

Accede al log de errores en Syspanel

Entra a tu panel de Syspanel usando el puerto 2106 (por ejemplo: https://tudominio.com:2106).
Inicia sesión con tu usuario y contraseña de administrador.
Busca la sección de "Registros" o "Logs" (normalmente está en el menú lateral).
Abre el log de errores de Apache o Nginx (dependiendo de cuál uses). También puedes revisar el log de PHP si existe.

[TIP] Si no encuentras los logs, puedes activar la visualización de errores en PrestaShop temporalmente. Edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Esto mostrará el error real en pantalla. No olvides revertirlo al final.

Errores comunes que verás

PHP Fatal error: Allowed memory size exhausted → Problema de memoria.
PHP Parse error: syntax error, unexpected ... → Archivo PHP corrupto.
Permission denied → Permisos de archivos o carpetas incorrectos.
Class not found → Módulo o override roto.

Solución 1: Aumenta el límite de memoria PHP

Uno de los culpables más frecuentes del error 500 PrestaShop es la falta de memoria PHP. PrestaShop es una plataforma bastante exigente, y si tu tienda tiene muchos módulos o productos, puede agotar el límite permitido.

Cómo aumentarlo desde Syspanel

Ve a Syspanel en el puerto 2106.
Busca la opción de "PHP" o "Configuración PHP".
Localiza el parámetro memory_limit y cámbialo a 512M o incluso 1024M si tu servidor tiene recursos disponibles.
Guarda los cambios y reinicia PHP (o el servicio web).

Si no tienes acceso a esa opción

Puedes hacerlo manualmente editando el archivo php.ini:

Accede por FTP o por el administrador de archivos de Syspanel.
Busca el archivo php.ini en la carpeta de tu dominio (normalmente en public_html o web).
Agrega o modifica la línea: memory_limit = 512M.
Guarda y recarga.

[WARNING] Si no encuentras php.ini, crea un archivo llamado php.ini en la raíz de tu tienda y escribe dentro memory_limit = 512M. A veces funciona, pero lo ideal es hacerlo desde el panel.

Solución 2: Revisa los permisos de archivos y carpetas

Los permisos incorrectos son otra causa clásica de Syspanel error y de errores 500 en general. Si algún archivo no se puede leer o escribir, PrestaShop falla.

Permisos correctos para PrestaShop

Archivos: 644
Carpetas: 755
Carpeta config: 755
Carpeta cache: 755 (y vacía si es posible)
Carpeta log: 755

Cómo cambiarlos desde Syspanel

Entra a tu panel Syspanel (puerto 2106).
Ve a "Administrador de archivos" o usa tu cliente FTP favorito.
Selecciona todos los archivos y carpetas de tu instalación de PrestaShop.
En la opción de permisos (chmod), aplica los valores mencionados.
Aplica también a las subcarpetas recursivamente.

[TIP] Si usas FTP, selecciona todo, clic derecho → "Permisos" → escribe 755 para carpetas y 644 para archivos. No olvides marcar la casilla de "aplicar a subcarpetas".

Solución 3: Limpia la caché de PrestaShop

A veces el error 500 es simplemente un problema de caché corrupta. PrestaShop guarda archivos temporales que pueden dañarse y provocar fallos.

Limpieza manual

Accede a tu servidor por FTP o por el administrador de archivos de Syspanel.
Entra en la carpeta var/cache (o cache en versiones antiguas).
Borra todo el contenido de esa carpeta, pero no borres la carpeta en sí.
También puedes borrar el contenido de var/logs (o log).
Recarga tu tienda.

Limpieza desde el panel de administración

Si aún puedes acceder al backoffice de PrestaShop:

Ve a Parámetros avanzados → Rendimiento.
Haz clic en "Vaciar la caché".
Si tienes la opción de "Forzar la compilación", actívala temporalmente.
Guarda y vuelve a desactivarla.

[INFO] Si no puedes acceder al backoffice, la limpieza manual desde FTP es igual de efectiva.

Solución 4: Desactiva módulos o overrides problemáticos

Un módulo recién instalado o actualizado puede ser el causante del error 500 PrestaShop. Si el error apareció justo después de instalar algo nuevo, ese es tu sospechoso número uno.

Desactivar módulos sin acceso al backoffice

Accede por FTP a la carpeta modules.
Busca el módulo sospechoso (el que instalaste recientemente).
Renombra la carpeta del módulo añadiendo un guion bajo al inicio, por ejemplo: _nombre_modulo.
Recarga tu tienda. Si ya funciona, ese era el problema.
Si no sabes cuál es, renombra todos los módulos de uno en uno hasta encontrar al culpable.

Desactivar overrides

Los overrides son personalizaciones que a veces causan conflictos.

Ve a override/classes y override/controllers.
Renombra los archivos que estén ahí (por ejemplo, añade .bak al final).
Prueba de nuevo.

[WARNING] Haz siempre una copia de seguridad antes de renombrar o borrar archivos. Nunca trabajes sin red de seguridad.

Solución 5: Revisa el archivo `.htaccess`

Un .htaccess corrupto o mal configurado puede provocar un error 500 inmediato. Esto es muy común después de cambios en la configuración de la tienda.

Regenerar el .htaccess

Accede a tu tienda por FTP.
Busca el archivo .htaccess en la raíz (si no lo ves, activa la opción de "mostrar archivos ocultos" en tu cliente FTP).
Renómbralo a .htaccess.bak.
Intenta acceder a tu tienda.
Si funciona, entra al backoffice y ve a Parámetros avanzados → Rendimiento y haz clic en "Guardar" para regenerar el archivo automáticamente.

Si no tienes backoffice

Puedes crear un .htaccess limpio con el contenido básico para PrestaShop. Pero es más fácil pedirle a tu hosting que lo regenere o restaurar una copia de seguridad.

[TIP] Nunca edites el .htaccess directamente si no estás seguro. Un error de sintaxis puede tirar toda la tienda.

Solución 6: Verifica la versión de PHP y compatibilidad

PrestaShop es sensible a la versión de PHP. Si tu servidor usa una versión demasiado nueva o demasiado antigua, pueden aparecer errores 500.

Versiones recomendadas

PrestaShop 1.7 y 8.x: PHP 7.2 a 8.1 (idealmente 8.0 o 8.1).
PrestaShop 1.6: PHP 5.6 a 7.1.
PrestaShop 1.5 o inferior: PHP 5.3 a 5.6.

Cómo cambiar la versión de PHP en Syspanel

Entra a Syspanel (puerto 2106).
Ve a "PHP" o "Versión PHP".
Selecciona la versión compatible con tu PrestaShop.
Guarda y espera unos segundos.
Recarga tu tienda.

[INFO] Si cambias de versión de PHP, algunos módulos pueden dejar de funcionar. Revisa siempre la compatibilidad de tus módulos antes de cambiar.

Solución 7: Revisa el espacio en disco y los límites del servidor

A veces el error 500 no es por un archivo en concreto, sino por falta de recursos del servidor.

Comprueba el espacio libre

Entra a Syspanel.
Ve a la sección de "Estadísticas" o "Uso de disco".
Si el disco está lleno (más del 90%), libera espacio eliminando copias de seguridad antiguas, logs o cachés.

Límites de ejecución

max_execution_time: si es muy bajo, procesos largos (como importar productos) fallan.
max_input_vars: si es muy bajo, formularios grandes fallan.

Ajústalos desde la configuración PHP de Syspanel o desde php.ini.

[WARNING] Un disco lleno no solo causa errores 500, sino que puede corromper la base de datos. Actúa rápido.

Solución 8: Restaura una copia de seguridad

Si nada de lo anterior funciona, la solución más rápida y segura es restaurar una copia de seguridad reciente.

Desde Syspanel

Ve a "Copias de seguridad" en tu panel (puerto 2106).
Selecciona la copia más reciente (preferiblemente de antes de que apareciera el error).
Restaura tanto los archivos como la base de datos.
Espera a que termine y prueba tu tienda.

Restauración manual

Si no tienes copia en Syspanel, pero tienes una copia en tu ordenador:

Sube los archivos por FTP (reemplazando los actuales).
Importa el backup de la base de datos desde phpMyAdmin (accesible desde Syspanel).
Limpia la caché.

[TIP] Siempre mantén al menos dos copias de seguridad: una en el servidor y otra local. Nunca sabes cuándo las vas a necesitar.

Preguntas frecuentes (FAQ)

¿Cuánto tiempo se tarda en solucionar un error 500 en PrestaShop?

Depende de la causa. Si es un problema de permisos o caché, en 5 minutos lo tienes. Si es un módulo conflictivo, puede llevarte 30 minutos. Si hay que restaurar una copia, entre 30 y 60 minutos.

¿Puedo perder datos si restauro una copia de seguridad?

Sí, perderás todo lo que se haya hecho desde la fecha de la copia. Por eso es importante tener copias frecuentes y saber qué cambios hiciste recientemente.

¿El error 500 afecta al SEO de mi tienda?

Sí, si el error dura mucho tiempo, Google puede penalizar tu tienda, ya que los usuarios no pueden acceder. Lo ideal es solucionarlo en menos de 24 horas.

¿Debo llamar a mi proveedor de hosting?

Si has probado todos los pasos anteriores y el error persiste, sí. Ellos tienen acceso a logs más profundos y pueden ver si hay problemas en el servidor a nivel global.

Conclusión

El error 500 Internal Server Error en PrestaShop es frustrante, pero casi siempre tiene solución. Siguiendo estos pasos en orden, podrás identificar la causa y arreglarla sin necesidad de ser un experto en sistemas.

Recuerda que Syspanel (el panel de HestiaCP en el puerto 2106) te da todas las herramientas necesarias: logs, permisos, configuración PHP y copias de seguridad. Usa todo lo que tienes a tu disposición.

Y si te quedas atascado, no dudes en contactar con tu soporte técnico. A veces una segunda opinión (y un par de ojos expertos) es todo lo que necesitas para que tu tienda online vuelva a estar operativa.

[INFO] Guarda este artículo en tus favoritos. La próxima vez que veas un error 500, ya sabrás exactamente qué hacer.