Guía para solucionar errores 500 en PrestaShop con Syspanel

¿Qué es el temido error 500 en PrestaShop?

Si estás leyendo esto, probablemente te has encontrado con una pantalla en blanco o un mensaje como "Error interno del servidor" (HTTP 500) en tu tienda PrestaShop. No te preocupes: es uno de los errores más comunes en el mundo del hosting, y en la mayoría de los casos se puede solucionar sin ser un experto técnico.

El error 500 es un código genérico que indica que algo salió mal en el servidor, pero no especifica qué. Puede deberse a un problema de permisos, un archivo de configuración dañado, un módulo incompatible o incluso un límite de memoria excedido. En esta guía, te explicaré paso a paso cómo diagnosticar y solucionar el error 500 PrestaShop Syspanel usando las herramientas que tienes a tu disposición en tu panel de control (Syspanel, accesible por el puerto 2106).

Primeros pasos: antes de tocar nada

Antes de lanzarte a modificar archivos, toma un respiro y sigue estos pasos iniciales. Muchas veces el error es temporal o se soluciona con una acción simple.

1. Recarga la página y borra la caché del navegador

A veces el error 500 es intermitente. Prueba a recargar la página (F5) y, si no funciona, borra la caché de tu navegador (Ctrl+Shift+Supr en Chrome/Firefox). También puedes probar en una ventana de incógnito.

2. Comprueba si el error afecta a toda la tienda o solo a una página

Si solo falla una sección (por ejemplo, el carrito o una categoría), el problema puede estar en un módulo específico. Si toda la tienda da error 500, el origen es más global.

3. Revisa el estado del servicio en Syspanel

Accede a tu Syspanel (puerto 2106) y verifica que Apache/Nginx y PHP estén funcionando correctamente. Desde el panel principal, busca la sección "Servicios" o "Estado del servidor". Si algún servicio aparece detenido, reinícialo.

[INFO] Syspanel es el nombre comercial de HestiaCP. Para acceder, escribe en tu navegador: https://tudominio.com:2106 e inicia sesión con tus credenciales de hosting.

Diagnóstico avanzado: encuentra la causa raíz

Si el error persiste, necesitas investigar un poco más. Aquí te muestro las herramientas clave dentro de Syspanel y cómo usarlas.

1. Activa el modo debug de PrestaShop

PrestaShop tiene un modo de depuración que muestra errores detallados en lugar de la pantalla en blanco. Para activarlo, necesitas editar el archivo config/defines.inc.php de tu instalación.

Pasos:

1. Accede a Syspanel y ve a "Administrador de archivos" (File Manager).
2. Navega hasta public_html/config/ (o la carpeta donde tengas instalado PrestaShop).
3. Abre el archivo defines.inc.php con el editor de texto integrado.
4. Busca la línea: define('_PS_MODE_DEV_', false);
5. Cámbiala a: define('_PS_MODE_DEV_', true);
6. Guarda el archivo.

Ahora, al recargar la página, verás un mensaje de error mucho más descriptivo, como "Fatal error: Allowed memory size exhausted" o "Class not found". Eso te dará pistas claras.

[WARNING] No olvides volver a poner false una vez resuelto el error, o tu tienda mostrará información sensible a los visitantes.

2. Revisa los logs del servidor desde Syspanel

Syspanel guarda registros de errores del servidor web y de PHP. Son tu mejor aliado.

Cómo acceder a los logs:

1. En Syspanel, ve a "Registros" (Logs) o "Estadísticas".
2. Busca el log de errores de Apache/Nginx (normalmente llamado error.log).
3. También puedes revisar el log de PHP (suele estar en /var/log/php-fpm/ o similar, pero desde Syspanel suele haber un acceso directo).

Los logs mostrarán líneas como:

[Wed Oct 25 10:00:00 2023] [error] [client 192.168.1.1] PHP Fatal error:  Uncaught exception 'Exception' with message '...' in /public_html/modules/mimodulo/mimodulo.php:123

Anota el archivo y la línea que aparece; ahí está la pista.

3. Comprueba los permisos de archivos y carpetas

Los permisos incorrectos son una causa frecuente de error 500 en PrestaShop. Los valores recomendados son:

• Carpetas: 755
• Archivos: 644
• Archivos de configuración (como settings.inc.php): 644

Cómo corregirlos desde Syspanel:

1. Ve a "Administrador de archivos".
2. Selecciona toda la carpeta public_html (o la raíz de tu tienda).
3. Haz clic en "Permisos" y establece 755 para carpetas y 644 para archivos.
4. Si hay algún archivo con permisos 777 (escritura global), cámbialo a 644.

[TIP] Si usas FTP, también puedes cambiar permisos desde tu cliente FTP (FileZilla, etc.). En Syspanel, es más rápido porque puedes seleccionar todo a la vez.

Soluciones comunes para el error 500 en PrestaShop

Basado en la experiencia, estos son los problemas más habituales y cómo arreglarlos.

1. Límite de memoria PHP excedido

Si el error dice "Allowed memory size of X bytes exhausted", necesitas aumentar el límite.

Cómo hacerlo en Syspanel:

1. Ve a "Configuración del servidor" > "PHP" o "Editar PHP".
2. Busca la opción memory_limit y cámbiala a un valor más alto, por ejemplo, 256M o 512M.
3. Guarda y reinicia el servicio PHP (desde "Servicios").

Si no puedes editarlo desde el panel, puedes crear un archivo php.ini en la raíz de tu tienda con esta línea:

memory_limit = 256M

2. Módulo o tema incompatible

Los módulos desactualizados o mal codificados son otra causa común. Si activaste el modo debug y ves un error que menciona un módulo, desactívalo temporalmente.

Pasos:

1. Accede a tu base de datos desde Syspanel (phpMyAdmin o similar).
2. Busca la tabla ps_module (el prefijo puede variar).
3. Localiza el módulo problemático y cambia su estado de 1 a 0 (activo a inactivo).
4. Alternativamente, renombra la carpeta del módulo en /modules/nombredelmodulo a /modules/nombredelmodulo_backup para desactivarlo.

3. Archivo .htaccess corrupto

PrestaShop genera un archivo .htaccess que a veces se daña. Puedes regenerarlo desde el panel de administración de PrestaShop, pero si no puedes acceder, hazlo manualmente.

Cómo regenerar el .htaccess desde Syspanel:

1. En "Administrador de archivos", localiza el archivo .htaccess en la raíz.
2. Renómbralo a .htaccess_backup.
3. Ve a tu panel de administración de PrestaShop (si accedes) y ve a "Parámetros de la tienda" > "Tráfico y SEO" y haz clic en "Guardar" para regenerarlo.
4. Si no puedes acceder al panel, crea un nuevo .htaccess con el contenido básico que proporciona PrestaShop (puedes copiarlo de una instalación limpia o pedírselo a tu soporte).

4. Problemas con la base de datos

A veces la base de datos se corrompe o tiene tablas bloqueadas. Desde Syspanel puedes repararla.

Pasos:

1. Ve a "phpMyAdmin" (dentro de Syspanel, en la sección de bases de datos).
2. Selecciona la base de datos de tu tienda.
3. En la pestaña "Operaciones", busca "Reparar tabla" o "Optimizar tabla".
4. También puedes ejecutar desde SQL: REPAIR TABLE nombre_de_la_tabla;

[INFO] Si no sabes qué tabla está dañada, los logs del servidor suelen indicarlo. Busca mensajes como "Table 'ps_product' is marked as crashed".

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop con Syspanel

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

Es muy probable que el módulo no sea compatible con tu versión de PrestaShop o de PHP. Desactívalo desde la base de datos como te expliqué antes, y luego contacta al desarrollador.

¿El error 500 puede deberse a una actualización de PHP?

Sí. Si tu hosting actualizó PHP a una versión más reciente (por ejemplo, de 7.4 a 8.0), algunos módulos o el propio PrestaShop pueden dejar de funcionar. Desde Syspanel puedes cambiar la versión de PHP en "Configuración del servidor" > "PHP". Prueba con una versión anterior.

¿Cómo restauro una copia de seguridad desde Syspanel?

Syspanel incluye un sistema de backups. Ve a "Copia de seguridad" y selecciona la fecha anterior al error. Puedes restaurar solo archivos o también la base de datos. Esto es útil si el error apareció después de un cambio reciente.

¿Qué hago si no puedo acceder ni al panel de administración de PrestaShop?

Si el error 500 te bloquea también el acceso al back-office, usa el modo debug editando el archivo defines.inc.php vía FTP o el administrador de archivos de Syspanel. Si ni siquiera puedes hacer eso, restaura una copia de seguridad completa.

¿Debo contactar al soporte técnico?

Si después de seguir todos estos pasos el error persiste, contacta a tu proveedor de hosting. Proporciónales los logs del servidor y el mensaje exacto del modo debug. Ellos podrán revisar la configuración del servidor (como límites de recursos o errores de Apache) que no están a tu alcance.

Consejos finales para evitar futuros errores 500

• Mantén PrestaShop actualizado: Usa siempre la última versión estable de PrestaShop y de sus módulos.
• Haz copias de seguridad periódicas: Desde Syspanel puedes programar backups automáticos diarios o semanales.
• No instales módulos de fuentes dudosas: Prioriza el marketplace oficial de PrestaShop o desarrolladores de confianza.
• Controla los límites de recursos: Si tu tienda recibe mucho tráfico, considera aumentar el límite de memoria PHP y el tiempo de ejecución (max_execution_time).

Recuerda que el error 500, aunque frustrante, casi siempre tiene solución. Con esta guía y las herramientas de Syspanel (tu panel de control accesible en el puerto 2106), podrás diagnosticar y resolver el problema en la mayoría de los casos. ¡No te rindas!