Guía para solucionar error 500 en PrestaShop con Syspanel

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has encontrado con la temida pantalla blanca o el mensaje "Error 500 Internal Server Error" en tu tienda PrestaShop. No te preocupes, es un problema muy común y, con esta guía paso a paso, podrás solucionarlo usando el panel de control Syspanel (accesible por el puerto 2106). Vamos a ello.

¿Qué es el error 500 en PrestaShop?

El error 500 es un error genérico del servidor. Significa que algo salió mal internamente, pero el servidor no puede dar más detalles. En PrestaShop, esto suele deberse a:

• Archivos corruptos de la instalación o de un módulo.
• Problemas de memoria (límite de memoria PHP excedido).
• Errores en archivos .htaccess o de configuración.
• Permisos incorrectos en archivos o carpetas.
• Un módulo o tema incompatible que rompe la tienda.
• Versión de PHP incorrecta o incompatible con tu PrestaShop.

Primeros pasos antes de usar Syspanel

Antes de entrar en Syspanel, prueba estos pasos rápidos. A veces el error es temporal.

1. Actualiza la página con Ctrl + F5 (o Cmd + R en Mac) para forzar una recarga limpia del navegador.
2. Borra la caché de tu navegador y vuelve a cargar la tienda.
3. Prueba desde otro navegador o desde una ventana de incógnito. A veces una extensión del navegador causa conflictos.

Si el error persiste, pasamos a la acción con Syspanel.

Accediendo a Syspanel para solucionar el error 500

Syspanel es tu herramienta de administración del servidor. Para acceder:

• Abre tu navegador y escribe: https://tudominio.com:2106 (recuerda, el puerto es 2106).
• Inicia sesión con tus credenciales de Syspanel (las mismas que usas para el hosting).

[WARNING] Si no recuerdas tu contraseña de Syspanel, contacta con tu proveedor de hosting. No intentes adivinarla, podrías bloquear el acceso.

Una vez dentro, sigue estos pasos en orden. Te recomiendo hacerlos uno a uno y comprobar si el error se soluciona.

1. Activar el modo debug de PrestaShop

El modo debug te mostrará el error específico, en lugar de la pantalla genérica. Es el primer paso para entender qué pasa.

1. En Syspanel, ve a "Administrador de archivos" o "Gestor de archivos".
2. Navega hasta la carpeta raíz de tu PrestaShop (normalmente public_html, www o el nombre de tu dominio).
3. Busca el archivo config/defines.inc.php.
4. Ábrelo con el editor de texto de Syspanel (clic derecho > "Editar").
5. Busca la línea que dice: define('_PS_MODE_DEV_', false);
6. Cámbiala a: define('_PS_MODE_DEV_', true);
7. Guarda los cambios y cierra el archivo.
8. Vuelve a cargar tu tienda. Ahora deberías ver un mensaje de error más detallado (por ejemplo, "Fatal error: Allowed memory size...", "Class not found...", etc.). Anota ese mensaje, te ayudará más adelante.
9. Importante: Una vez solucionado el error, vuelve a poner false en esa línea para desactivar el modo debug en producción.

2. Aumentar el límite de memoria PHP

Uno de los culpables más frecuentes del error 500 es que PrestaShop se queda sin memoria. Vamos a aumentarla.

1. En Syspanel, busca la sección "Configuración PHP" o "PHP Settings".
2. Busca la opción memory_limit.
3. Aumenta el valor. Para PrestaShop, recomiendo al menos 256M (256 megabytes). Si tienes muchos módulos, sube a 512M o 1024M.
4. Guarda los cambios.
5. Vuelve a cargar tu tienda.

[TIP] Si no encuentras la opción memory_limit, puedes crearla manualmente en el archivo php.ini (si existe) o en un archivo .user.ini en la raíz de tu PrestaShop. Escribe: memory_limit = 256M.

3. Deshabilitar módulos problemáticos desde la base de datos

A veces un módulo recién instalado o actualizado rompe todo. Como no podemos acceder al backoffice, lo desactivamos desde la base de datos.

1. En Syspanel, ve a "phpMyAdmin" o "Bases de datos".
2. Selecciona la base de datos de tu PrestaShop.
3. Busca la tabla ps_module (el prefijo puede ser distinto, como ps_ o prestashop_).
4. Haz clic en "Examinar" o "Browse" para ver los módulos.
5. Busca el módulo sospechoso (por ejemplo, el último que instalaste o actualizaste). Fíjate en la columna active.
6. Si está en 1 (activo), cámbialo a 0 (inactivo). Puedes hacerlo editando la fila.
7. Guarda los cambios y vuelve a cargar tu tienda.

[WARNING] Si no sabes qué módulo es el problemático, desactiva todos los módulos de pago o de terceros primero. Para desactivar todos a la vez, puedes ejecutar esta consulta SQL en phpMyAdmin (en la pestaña "SQL"): UPDATE ps_module SET active = 0 WHERE id_module > 1; (esto desactiva todos excepto los núcleo). Luego ve activándolos uno a uno.

4. Restaurar el archivo .htaccess

Un archivo .htaccess corrupto o mal configurado puede causar el error 500.

1. En Syspanel, ve al "Administrador de archivos".
2. Navega a la raíz de tu PrestaShop.
3. Busca el archivo .htaccess (puede estar oculto; activa "Mostrar archivos ocultos" en la configuración del administrador de archivos).
4. Renómbralo a .htaccess_backup (por si acaso).
5. Ahora, desde el backoffice de PrestaShop (si logras acceder), ve a Parámetros de la tienda > Tráfico y SEO y haz clic en "Guardar" sin cambiar nada. Esto regenerará el archivo .htaccess automáticamente.
6. Si no puedes acceder al backoffice, crea un nuevo archivo .htaccess vacío o copia uno de una instalación limpia de PrestaShop de la misma versión.

5. Verificar permisos de archivos y carpetas

Los permisos incorrectos (por ejemplo, archivos con permisos 777 o carpetas con 644) pueden provocar errores.

1. En Syspanel, en el "Administrador de archivos", selecciona toda la carpeta de tu PrestaShop (clic en la casilla de la carpeta raíz).
2. Busca la opción "Permisos" o "Change permissions".
3. Establece los permisos recomendados:
   • Carpetas: 755 (o 750 en entornos más seguros).
   • Archivos: 644 (o 640).
   • Archivos de configuración (como config/settings.inc.php): 644.
4. Aplica los cambios de forma recursiva (a todas las subcarpetas y archivos).
5. Vuelve a cargar tu tienda.

[INFO] Si tu servidor usa un usuario diferente al de FTP, los permisos 755/644 suelen ser suficientes. No uses 777 a menos que sea estrictamente necesario y temporal.

6. Cambiar la versión de PHP

PrestaShop necesita una versión de PHP específica. Si tu servidor tiene una versión muy nueva o muy antigua, pueden aparecer errores.

1. En Syspanel, busca "Versión PHP" o "PHP Selector".
2. Cambia la versión de PHP. Para PrestaShop 1.7, lo ideal es PHP 7.4 o 8.0. Para PrestaShop 1.6, PHP 7.0 o 7.1.
3. Guarda los cambios y espera unos segundos a que se aplique.
4. Recarga tu tienda.

7. Revisar los logs del servidor

Si nada de lo anterior funciona, los logs del servidor te darán la pista definitiva.

1. En Syspanel, busca "Registros" o "Logs".
2. Busca los logs de error de PHP o de Apache/Nginx.
3. Descarga o visualiza el archivo de logs más reciente (suele llamarse error.log o php_error.log).
4. Busca la línea que coincida con la hora en que apareció el error 500. Allí verás el error exacto (por ejemplo, "PHP Fatal error: Uncaught Error: Class 'Module' not found...").

Preguntas frecuentes (FAQ)

¿Por qué aparece el error 500 después de instalar un módulo?

Es muy común. El módulo puede ser incompatible con tu versión de PrestaShop o con otros módulos. Sigue el paso 3 (deshabilitar módulos desde la base de datos) para desactivarlo.

¿El error 500 puede deberse a un tema?

Sí, sobre todo si el tema no está actualizado. Prueba a cambiar temporalmente al tema predeterminado (por ejemplo, "Classic" en PrestaShop 1.7) desde la base de datos. Busca la tabla ps_configuration y cambia el valor de PS_THEME_NAME.

¿Qué hago si después de todo el error persiste?

Si has seguido todos los pasos y el error sigue, puede ser un problema más profundo del servidor. Contacta con tu proveedor de hosting y muéstrales los logs de error que obtuviste en el paso 7. Ellos podrán revisar la configuración del servidor.

¿Debo activar el modo debug siempre?

No. Solo actívalo para diagnosticar el problema. Una vez solucionado, desactívalo para evitar mostrar información sensible a los visitantes.

Resumen final

El error 500 en PrestaShop puede ser frustrante, pero con Syspanel tienes todas las herramientas para solucionarlo. Recuerda el orden lógico:

1. Activar modo debug para ver el error específico.
2. Aumentar memoria PHP (solución rápida común).
3. Deshabilitar módulos desde la base de datos.
4. Restaurar .htaccess y verificar permisos.
5. Cambiar versión de PHP si es necesario.
6. Revisar logs como último recurso.

Y lo más importante: siempre haz una copia de seguridad de tu base de datos y archivos antes de hacer cambios drásticos. Syspanel suele tener una opción de "Backup" fácil de usar.

Espero que esta guía te haya sido de ayuda. Si tienes más dudas, no dudes en preguntar. ¡Buena suerte con tu tienda!