Error 500 en PrestaShop Syspanel | Cómo solucionarlo

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

Cuando tu tienda online muestra el temido error 500 Internal Server Error, significa que algo ha fallado en el servidor pero este no puede darte más detalles. Es un error genérico que afecta a la configuración del servidor, a los archivos de tu instalación o a un conflicto entre módulos y temas.

En el caso concreto de una tienda gestionada con Syspanel (el panel de control que antes conocías como HestiaCP y al que accedes por el puerto 2106), el error 500 suele estar relacionado con permisos de archivos incorrectos, límites de memoria PHP agotados o errores en el archivo .htaccess.

Lo más importante es que no entres en pánico. Este error tiene solución y en la mayoría de los casos puedes resolverlo tú mismo siguiendo una serie de pasos lógicos. A continuación, te explicamos cómo diagnosticar y solucionar error 500 paso a paso, incluso si no tienes experiencia técnica avanzada.

Primeros pasos: identifica el alcance del problema

Antes de tocar nada, necesitas saber si el error afecta a toda la tienda o solo a algunas páginas. Esta información te dará pistas sobre el origen del problema.

Prueba con el front office y el back office

Accede a la URL pública de tu tienda. Si ves el error 500 prestashop syspanel, prueba a entrar también en tu panel de administración (normalmente tudominio.com/admin).

Si ambas partes fallan, el problema es global y probablemente esté en los archivos base o en la configuración del servidor.
Si solo falla el front office pero el back office carga, el origen está en un tema, módulo o en la caché.
Si solo falla el back office, el problema puede estar en un módulo de administración o en la sesión.

Activa el modo de depuración de PrestaShop

PrestaShop tiene un modo de depuración que muestra los errores PHP reales en pantalla. Para activarlo necesitas editar el archivo config/defines.inc.php de tu instalación.

Accede a tu panel de Syspanel por el puerto 2106 y utiliza el administrador de archivos o el acceso FTP para localizar la carpeta config en la raíz de tu tienda.

Abre el archivo defines.inc.php.
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cambia false por true.
Guarda los cambios y recarga tu tienda.

Si el error 500 se convierte en un mensaje de error PHP concreto (como "Allowed memory size exhausted" o "Fatal error"), ya tienes la pista exacta. Anota el mensaje y la ruta del archivo que lo causa.

[WARNING] No olvides volver a poner false cuando termines de diagnosticar. Dejar el modo desarrollo activo en producción es un riesgo de seguridad.

Los 5 culpables más habituales del error 500 en PrestaShop

Basándonos en la experiencia con cientos de tiendas alojadas en Syspanel, estos son los desencadenantes más comunes:

1. Permisos de archivos y carpetas incorrectos

PrestaShop necesita permisos específicos para leer y escribir archivos. Si después de una migración o restauración los permisos se han cambiado, el servidor no puede acceder a los archivos y devuelve el error 500.

Las carpetas deben tener permisos 755.
Los archivos deben tener permisos 644.
La carpeta var/cache y var/logs deben ser escribibles (a veces requieren 775).

Puedes cambiar los permisos desde el administrador de archivos de Syspanel o con un cliente FTP como FileZilla. Selecciona todos los archivos y carpetas de la raíz y aplica los permisos correspondientes.

2. Archivo .htaccess corrupto o incompatible

El archivo .htaccess de PrestaShop contiene reglas de reescritura de URL. Si se ha dañado o contiene directivas incompatibles con la configuración de tu servidor, la tienda no cargará.

Para solucionarlo, sigue estos pasos:

Entra en Syspanel (puerto 2106) y localiza el archivo .htaccess en la raíz.
Descarga una copia de seguridad por seguridad.
Elimina el archivo .htaccess del servidor.
Ve al back office de PrestaShop (si puedes acceder) a Parámetros avanzados > Rendimiento.
Activa la opción "Regenerar el archivo .htaccess" y guarda.

Si no puedes acceder al back office, crea un archivo .htaccess nuevo con el contenido básico que PrestaShop genera automáticamente al activar la URL amigable. La próxima vez que cargues la tienda, se regenerará.

3. Límite de memoria PHP insuficiente

PrestaShop es exigente con la memoria. Si tu tienda ha crecido o has instalado módulos pesados, el límite por defecto de 128M puede quedarse corto y provocar el error 500 prestashop syspanel.

Para aumentar el límite de memoria PHP:

Accede a Syspanel por el puerto 2106.
Ve a la sección de configuración PHP de tu dominio.
Busca el valor memory_limit y cámbialo a 256M o 512M.
Guarda los cambios y reinicia PHP si es necesario.

También puedes crear un archivo php.ini personalizado en la raíz de tu tienda con el siguiente contenido:

memory_limit = 512M
max_execution_time = 300
upload_max_filesize = 64M
post_max_size = 64M

4. Módulos o temas incompatibles

Un módulo mal codificado o un tema desactualizado pueden generar un error fatal de PHP. Esto es especialmente común después de actualizar PrestaShop a una versión más reciente.

Para identificar al culpable:

Renombra la carpeta modules a modules_backup temporalmente.
Prueba a cargar la tienda. Si ahora funciona, el problema está en un módulo.
Ve renombrando los módulos de uno en uno (o por lotes) hasta encontrar el conflictivo.
Cuando lo localices, actualízalo o elimínalo.

[TIP] Haz lo mismo con la carpeta themes. Cambia el nombre del tema activo a themes_backup y PrestaShop usará el tema por defecto. Si la tienda carga, el tema es el problema.

5. Base de datos corrupta o incompleta

A veces el error 500 no está en los archivos sino en la base de datos. Una tabla dañada o una consulta malformada puede hacer que PrestaShop falle al intentar conectarse.

Desde Syspanel (puerto 2106) tienes acceso a phpMyAdmin. Dentro de la base de datos de tu tienda:

Selecciona todas las tablas.
En el menú desplegable elige "Reparar tabla".
Espera a que termine el proceso y prueba de nuevo.

Si la reparación no funciona, revisa los logs de errores de MySQL en Syspanel para ver si hay algún mensaje de tabla inexistente o columna incorrecta.

Cómo usar los logs para encontrar el error exacto

Los logs son tu mejor aliado para solucionar error 500 en PrestaShop. En Syspanel puedes acceder a los registros de errores del servidor y de PHP.

Logs de error de PHP

Dentro de Syspanel, busca la sección de "Logs" o "Registros" de tu dominio. El archivo error.log o php-error.log suele contener las entradas más recientes.

Abre el log y busca la fecha y hora en la que empezó el error. Verás líneas como:

[16-Oct-2024 10:23:45] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted

Esa línea te dice exactamente qué ha fallado y en qué archivo. Si el error hace referencia a un módulo concreto, ya sabes por dónde empezar.

Logs de error de PrestaShop

PrestaShop guarda sus propios logs en la carpeta var/logs. Si tienes activado el modo desarrollo, también verás los errores en pantalla.

[INFO] En PrestaShop 1.7 y versiones posteriores, los logs están en var/logs/ y se dividen por entorno (dev, prod). El archivo prod.log es el que necesitas consultar.

Soluciones avanzadas si el error persiste

Si has probado todo lo anterior y la tienda sigue mostrando el error 500 prestashop syspanel, estas opciones avanzadas te ayudarán.

Restaurar una copia de seguridad

Si tienes una copia de seguridad reciente de tu tienda (archivos y base de datos), restaurarla puede ser la solución más rápida. En Syspanel puedes hacerlo desde la sección de copias de seguridad.

Crea una copia de seguridad del estado actual (por si acaso).
Restaura la copia anterior al problema.
Comprueba que la tienda funciona.
Si funciona, el error fue causado por un cambio reciente (módulo, tema o actualización).

Aumentar el tiempo de ejecución de PHP

Algunas operaciones (como importar productos o generar PDFs) pueden superar el tiempo máximo de ejecución de PHP. Si el error 500 aparece al realizar estas acciones, aumenta max_execution_time a 300 segundos o más.

Verificar la versión de PHP

PrestaShop requiere una versión específica de PHP. Si tu versión es demasiado antigua o demasiado nueva, pueden aparecer errores fatales.

PrestaShop 1.7 funciona mejor con PHP 7.4 o 8.0.
PrestaShop 8.x requiere PHP 7.3 o superior (recomendado PHP 8.1).

En Syspanel puedes cambiar la versión de PHP desde la configuración de tu dominio. Prueba con una versión compatible y recarga la tienda.

Cuándo contactar con soporte técnico

Si después de seguir todos estos pasos el error 500 persiste, es hora de pedir ayuda profesional. Contacta con el soporte de tu hosting o con un desarrollador especializado en PrestaShop.

Antes de contactar, ten preparada esta información:

Fecha y hora exacta en la que empezó el error.
Mensajes de error de los logs de PHP.
Últimos cambios realizados (instalación de módulos, actualizaciones, migraciones).
Versión de PrestaShop y de PHP.

[WARNING] No intentes modificar archivos del núcleo de PrestaShop si no sabes lo que haces. Un cambio incorrecto puede empeorar la situación y comprometer la seguridad de tu tienda.

Preguntas frecuentes sobre el error 500 en PrestaShop

¿El error 500 puede deberse a un ataque de hackers?

Sí, es posible. Un ataque puede modificar archivos o inyectar código malicioso que provoque errores. Si sospechas de un ataque, revisa los archivos modificados recientemente y cambia todas las contraseñas.

¿Pierdo mis datos si restauro una copia de seguridad?

Solo perderás los cambios realizados después de la fecha de la copia. Por eso es importante tener copias de seguridad frecuentes. En Syspanel puedes programar copias automáticas diarias.

¿Por qué aparece el error solo en el móvil?

Esto suele deberse a la caché del navegador o a un tema responsive mal configurado. Prueba a borrar la caché del navegador móvil y a desactivar la caché de PrestaShop.

¿Cuánto tiempo se tarda en solucionar?

Depende de la causa. Los problemas de permisos o .htaccess se resuelven en minutos. Los conflictos de módulos pueden llevar una hora. Si hay que restaurar la base de datos, puede tardar más.

Resumen final: checklist para solucionar el error 500 en PrestaShop

Te dejamos un resumen de todo lo que debes comprobar en orden:

Activa el modo desarrollo para ver el error real.
Revisa los logs de PHP en Syspanel (puerto 2106).
Comprueba los permisos de archivos y carpetas (755 carpetas, 644 archivos).
Regenera o elimina el archivo .htaccess.
Aumenta el límite de memoria PHP a 256M o 512M.
Desactiva módulos y temas uno a uno.
Repara las tablas de la base de datos con phpMyAdmin.
Cambia la versión de PHP si es necesario.
Restaura una copia de seguridad anterior.
Contacta con soporte técnico si nada funciona.

El error 500 prestashop syspanel es frustrante, pero con paciencia y siguiendo estos pasos, la mayoría de los casos se resuelven sin necesidad de conocimientos avanzados. Recuerda siempre hacer copias de seguridad antes de realizar cambios y mantener tu tienda actualizada.

Si has llegado hasta aquí, ya tienes las herramientas y el conocimiento para diagnosticar y solucionar error 500 en tu tienda PrestaShop. Pon en práctica estos consejos y tu prestashop no carga será solo un mal recuerdo.