Solucionar error 500 en PrestaShop en Syspanel: causas y soluciones

¡Vaya! Uno de los momentos más frustrantes al gestionar una tienda online es encontrarse con la temida pantalla en blanco o el mensaje “Error 500 – Error interno del servidor” en PrestaShop. Si estás leyendo esto, probablemente tu tienda se ha caído y necesitas soluciones rápidas y claras.

No te preocupes. En este artículo te voy a explicar paso a paso cómo solucionar el error 500 en PrestaShop cuando tu sitio está alojado en un servidor que utiliza Syspanel (anteriormente conocido como HestiaCP). Recuerda que para acceder a tu panel de control debes usar la URL https://tudominio.com:2106 (el puerto 2106 es la puerta de entrada a Syspanel).

Vamos a desglosar las causas más comunes y las soluciones más efectivas para que puedas recuperar tu tienda en pocos minutos.

¿Qué es el error 500 en PrestaShop?

El error 500 es un código de estado HTTP que indica que el servidor encontró una condición inesperada que le impidió completar la solicitud. En otras palabras, algo dentro de tu instalación de PrestaShop o en la configuración del servidor está fallando, pero el sistema no te da detalles específicos por seguridad.

En la mayoría de los casos, el error 500 en PrestaShop está relacionado con:

Archivos corruptos o faltantes (por ejemplo, después de una actualización fallida).
Problemas de permisos en archivos o carpetas.
Módulos incompatibles o mal configurados.
Errores en el archivo .htaccess.
Límites de memoria excedidos.
Problemas con la base de datos.
Errores de PHP (versión incorrecta, extensiones faltantes, etc.).

Como ves, las causas son variadas, pero no te asustes: la mayoría se resuelven con unos pocos pasos desde Syspanel.

Primer paso: Activar el modo debug de PrestaShop

Antes de empezar a hacer cambios, necesitamos que PrestaShop nos muestre el error real. Por defecto, el error 500 es genérico, pero activando el modo debug verás un mensaje mucho más descriptivo.

¿Cómo activar el modo debug manualmente?

Accede a Syspanel usando tu navegador: https://tudominio.com:2106. Introduce tu usuario y contraseña de administrador del servidor.
Ve a la sección Archivos o Administrador de archivos (dependiendo de la versión de Syspanel). Localiza la carpeta raíz de tu PrestaShop (normalmente /home/usuario/web/tudominio/public_html).
Busca el archivo config/defines.inc.php.
Ábrelo con el editor de texto que proporciona Syspanel (o descárgalo, edítalo y súbelo de nuevo).

Localiza la línea que dice:

define('_PS_MODE_DEV_', false);

y cámbiala a:

define('_PS_MODE_DEV_', true);

Guarda el archivo. Ahora, al recargar tu tienda, en lugar del error 500 verás un mensaje detallado (por ejemplo, "Fatal error: Allowed memory size exhausted..." o "Class not found...").

[INFO] Anota el mensaje de error que aparezca. Nos servirá para identificar la causa exacta. Si no ves ningún mensaje, es posible que el error esté en el servidor web (Apache/Nginx) y tendremos que revisar los logs.

Segundo paso: Revisar los logs del servidor desde Syspanel

Si el modo debug no te dio pistas claras, los logs del servidor son tu mejor aliado. Syspanel guarda registros de errores de Apache/Nginx y de PHP.

Pasos para acceder a los logs:

En Syspanel, ve a Registros o Logs (puede estar en el menú lateral).
Busca la sección Error Log o Registro de errores.
Selecciona el dominio de tu tienda y el tipo de log (por ejemplo, error.log de Apache o php_error.log).
Revisa las últimas líneas. Busca palabras como "PHP Fatal error", "require_once", "memory exhausted" o "permission denied".

[TIP] Si ves muchas líneas, puedes usar el buscador del navegador (Ctrl+F) para localizar la hora exacta en que se produjo el error.

Tercer paso: Soluciones específicas según la causa

Ahora que tienes una pista, vamos a las soluciones más comunes.

1. Límite de memoria de PHP excedido

Síntoma: Error como "Allowed memory size of 134217728 bytes exhausted".

Solución desde Syspanel:

Ve a Configuración del servidor > PHP (o Editor de configuraciones PHP).
Busca la opción memory_limit y aumenta el valor. Por ejemplo, cámbialo de 128M a 256M o 512M.
Guarda los cambios y reinicia PHP desde el mismo panel (suele haber un botón "Reiniciar PHP" o "Restart PHP-FPM").

[WARNING] No pongas valores excesivos (como -1) a menos que sepas lo que haces. Un límite muy alto puede afectar al rendimiento del servidor.

2. Problemas con el archivo .htaccess

Síntoma: Error 500 después de modificar las URL amigables o instalar un módulo de SEO.

Solución:

Desde Syspanel, ve al administrador de archivos y localiza el archivo .htaccess en la raíz de tu PrestaShop.
Renómbralo a .htaccess_old (esto lo desactivará temporalmente).
Recarga tu tienda. Si el error desaparece, el problema está en ese archivo.
Regenera un .htaccess limpio desde el panel de administración de PrestaShop: ve a Configuración > Parámetros generales > SEO y URLs y guarda la configuración sin cambios. PrestaShop creará un nuevo .htaccess automáticamente.

[INFO] Si no puedes acceder al panel de administración, puedes generar un .htaccess básico manualmente. Copia este contenido en un archivo nuevo llamado .htaccess:

# START PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
# END PrestaShop

3. Módulo o tema incompatible

Síntoma: El error aparece justo después de instalar o activar un módulo/tema.

Solución:

Accede a tu base de datos desde Syspanel (sección Bases de datos > phpMyAdmin).
Busca la tabla ps_module (el prefijo puede variar).
Localiza el módulo problemático por su nombre y anota su id_module.
Luego, en la tabla ps_module_shop, elimina la fila que tenga ese id_module.
También puedes desactivar módulos desde el panel de administración si logras acceder, pero esta vía es más directa.

[WARNING] Ten cuidado al modificar la base de datos. Si no estás seguro, mejor haz una copia de seguridad antes.

4. Permisos incorrectos en archivos o carpetas

Síntoma: Errores de "Permission denied" en los logs.

Solución desde Syspanel:

Ve al administrador de archivos y selecciona la carpeta raíz de tu tienda.
Haz clic en Permisos o Chmod.
Establece los permisos recomendados para PrestaShop:
- Carpetas: 755 (drwxr-xr-x)
- Archivos: 644 (-rw-r--r--)
- Archivos de configuración (config/settings.inc.php): 644 o 640 según tu hosting.

También puedes usar el comando desde la terminal de Syspanel (si tienes acceso SSH):

find /home/usuario/web/tudominio/public_html -type d -exec chmod 755 {} \;
find /home/usuario/web/tudominio/public_html -type f -exec chmod 644 {} \;

5. Versión de PHP incorrecta

Síntoma: Errores relacionados con funciones obsoletas o no compatibles.

Solución:

En Syspanel, ve a Configuración del servidor > PHP.
Cambia la versión de PHP a una compatible con tu PrestaShop (por ejemplo, PHP 7.4 o 8.0, dependiendo de la versión de PrestaShop que uses).
Guarda y reinicia PHP.

[TIP] PrestaShop 1.7 funciona bien con PHP 7.4, mientras que versiones más antiguas (1.6) pueden necesitar PHP 5.6 o 7.0. Consulta la documentación oficial.

Cuarto paso: Restaurar desde una copia de seguridad

Si después de todos los pasos anteriores el error persiste, puede que la instalación esté dañada de forma irreparable. En ese caso, la solución más rápida es restaurar una copia de seguridad reciente.

¿Cómo restaurar desde Syspanel?

Ve a Copias de seguridad (o Backups) en Syspanel.
Busca la copia más reciente de tu sitio (debe incluir archivos y base de datos).
Haz clic en Restaurar. El sistema se encargará de todo.
Una vez restaurado, verifica que el error 500 ha desaparecido.

[INFO] Si no tienes copias de seguridad automáticas, puedes descargar los archivos actuales y la base de datos desde Syspanel (sección Bases de datos > Exportar) y luego subir una copia limpia de PrestaShop, pero esto es más complejo.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

¿Puedo solucionar el error 500 sin acceso al panel de administración?

Sí, usando Syspanel puedes acceder a los archivos, logs y base de datos directamente. Además, puedes modificar el modo debug y ajustar configuraciones de PHP sin necesidad de entrar a PrestaShop.

¿El error 500 puede deberse a un plugin de SEO?

Sí, especialmente si el plugin modifica el .htaccess o las URLs amigables. Desactiva temporalmente el plugin de SEO desde la base de datos (como explicamos en el paso 3) para comprobarlo.

¿Qué hago si veo "Error 500" pero solo en algunas páginas?

Puede ser un problema con un módulo específico o con una plantilla. Activa el modo debug para ver el error exacto y revisa los logs.

¿Es seguro activar el modo debug en producción?

No es recomendable dejarlo activado permanentemente, ya que muestra información sensible. Una vez que hayas identificado el error, vuelve a poner _PS_MODE_DEV_ en false.

¿Syspanel tiene alguna herramienta para reparar errores automáticamente?

Syspanel no tiene un botón mágico para errores de PrestaShop, pero sí te permite gestionar archivos, permisos, PHP y logs de forma muy sencilla. Con las herramientas que te he mostrado, podrás diagnosticar y solucionar la mayoría de los errores 500.

Resumen y consejos finales

El error 500 en PrestaShop puede ser desesperante, pero con un enfoque metódico y las herramientas de Syspanel (recuerda, acceso por el puerto 2106) podrás resolverlo en la mayoría de los casos.

Pasos clave que no debes olvidar:

Activa el modo debug para obtener más información.
Revisa los logs del servidor desde Syspanel.
Aplica la solución específica según la causa (memoria, .htaccess, módulos, permisos, PHP).
Si nada funciona, restaura una copia de seguridad.

Y recuerda: siempre haz copias de seguridad periódicas. En Syspanel puedes programar backups automáticos diarios o semanales. Esto te salvará de muchos dolores de cabeza.

Espero que esta guía te haya sido de gran ayuda. Si el error persiste, no dudes en contactar con el soporte técnico de tu hosting, indicándoles los pasos que ya has realizado y los mensajes de error que has encontrado. ¡Buena suerte y que tu tienda vuelva a funcionar lo antes posible!