Error 500 en PrestaShop con Syspanel - Solución rápida

¿Qué significa exactamente el error 500 en PrestaShop?

Ver un error 500 PrestaShop en tu tienda es, sin duda, una de las experiencias más frustrantes para cualquier administrador. La pantalla se queda en blanco, tus clientes no pueden comprar y tú no sabes por dónde empezar a buscar el problema. Pero tranquilo, respira hondo.

Un error 500 Internal Server es un mensaje genérico que indica que algo ha fallado en el servidor, pero no te dice exactamente qué. Es como si el motor de tu coche se parara en mitad de la carretera y el tablero solo mostrara un signo de exclamación. La buena noticia es que, en la mayoría de los casos, se puede solucionar en pocos minutos si sabes dónde mirar.

En esta guía rápida y práctica, vamos a desgranar paso a paso cómo solucionar el error 500 en PrestaShop utilizando las herramientas que nos ofrece Syspanel, el panel de control que encontrarás en tu hosting. No necesitas ser un experto en programación; solo tienes que seguir estas instrucciones al pie de la letra.

¿Por qué aparece el error 500 en PrestaShop?

Antes de lanzarnos a arreglar nada, es útil entender las causas más comunes. Esto te ahorrará tiempo y te ayudará a prevenir futuros sustos. Las razones más frecuentes son:

Archivos con permisos incorrectos: Si los archivos de tu tienda tienen permisos demasiado restrictivos o demasiado abiertos, el servidor no puede leerlos o ejecutarlos correctamente.
Archivo .htaccess corrupto o incompatible: Este archivo es vital para el funcionamiento de PrestaShop. Si se daña durante una actualización o una modificación manual, todo el sistema colapsa.
Límite de memoria PHP agotado: PrestaShop es una plataforma que consume muchos recursos. Si tu plan de hosting tiene un límite de memoria bajo, es fácil que el sistema falle.
Módulos o temas incompatibles: A veces, instalar un módulo nuevo que no es compatible con tu versión de PrestaShop provoca un conflicto fatal.
Errores en el archivo settings.inc.php: Este archivo contiene la configuración de la base de datos. Si la contraseña de la base de datos cambia o el archivo se corrompe, tu tienda no podrá conectarse y lanzará el error 500.

Ahora que sabemos qué puede estar fallando, vamos a la acción. La clave aquí es usar Syspanel para diagnosticar y corregir el problema de manera ordenada.

Primer paso: Accede a Syspanel para ver los logs de error

Lo primero que necesitas es entrar a tu panel de control. Syspanel es la herramienta que te permite gestionar todos los aspectos de tu hosting, desde los archivos hasta las bases de datos. Para acceder, abre tu navegador y escribe la dirección de tu panel seguida del puerto: tu-dominio.com:2106. Recuerda que el puerto de acceso a Syspanel es siempre el 2106.

Una vez dentro, introduce tus credenciales de administrador. Si no las tienes a mano, contacta con tu proveedor de hosting para que te las facilite.

Revisando los logs de error en Syspanel

Los logs son el diario de tu servidor. Ahí se registra todo lo que ocurre, incluidos los errores. Para encontrarlos:

En el menú principal de Syspanel, busca la sección que se llama "Logs" o "Registros".
Dentro, verás varios tipos de archivos. El que nos interesa es el "Error Log" o "Registro de Errores".
Haz clic en él para abrirlo. Verás una lista de líneas con fechas y horas. Busca los errores que coincidan con el momento en que empezaste a ver el problema.

[INFO] El error más común que verás aquí es algo como PHP Fatal error: Allowed memory size of X bytes exhausted. Este mensaje te está diciendo que el problema es la memoria PHP. Si ves algo diferente, no te preocupes, los siguientes pasos te ayudarán igualmente.

Segundo paso: Solucionar el error 500 PrestaShop aumentando la memoria PHP

Si el log te muestra el error de memoria, o incluso si no estás seguro, aumentar el límite de memoria PHP es una solución muy efectiva y segura. Es como darle más combustible a tu coche para que no se cale.

Modificando el archivo .htaccess desde Syspanel

El archivo .htaccess es un archivo de configuración que se encuentra en la raíz de tu instalación de PrestaShop. Para modificarlo:

En Syspanel, navega al "Administrador de Archivos" (File Manager).
Ve a la carpeta public_html (o la carpeta donde esté instalada tu tienda).
Busca el archivo .htaccess. Es posible que esté oculto; en el administrador de archivos de Syspanel, suele haber una opción para "Mostrar archivos ocultos". Actívala si es necesario.
Haz clic derecho sobre el archivo y selecciona "Editar".
Al final del contenido del archivo, añade las siguientes líneas:

<IfModule mod_php7.c>
    php_value memory_limit 512M
    php_value max_execution_time 300
</IfModule>
<IfModule mod_php.c>
    php_value memory_limit 512M
    php_value max_execution_time 300
</IfModule>

[TIP] Si no estás seguro de si tu servidor usa PHP 7 o una versión anterior, añade ambos bloques. No causará ningún problema y cubrirá todas las posibilidades.

Guarda los cambios y cierra el editor.

Después de este cambio, intenta acceder a tu tienda. Si el error persiste, pasamos al siguiente paso.

Tercer paso: Reconstruir el archivo .htaccess desde el panel de administración

A veces, el archivo .htaccess está tan dañado que no se puede reparar simplemente añadiendo líneas. La solución más limpia es regenerarlo desde cero. PrestaShop tiene una función para hacer esto automáticamente.

Regenerando el .htaccess

Accede a tu panel de administración de PrestaShop (normalmente en tu-dominio.com/admin).
Ve al menú "Parámetros Avanzados" y luego a "Rendimiento".
En la parte superior, verás una sección que dice "Archivo .htaccess".
Haz clic en el botón "Guardar" o "Actualizar". Esto forzará a PrestaShop a generar un nuevo archivo .htaccess limpio.

[WARNING] Si no puedes acceder al panel de administración de PrestaShop porque también te da el error 500, no te preocupes. Puedes hacerlo manualmente:

Vuelve al Administrador de Archivos en Syspanel.
Busca el archivo .htaccess y renómbralo a .htaccess_bak (esto lo desactiva).
Ahora, intenta acceder a tu tienda. Si el error desaparece, el problema era el .htaccess.
Para crear uno nuevo, ve a la raíz de tu instalación y busca un archivo llamado .htaccess.sample. Si existe, renómbralo a .htaccess. Si no existe, tendrás que crear un archivo nuevo con un editor de texto y guardarlo como .htaccess (sin el punto al final en el nombre, solo .htaccess). El contenido mínimo debería ser el que añadimos en el paso anterior.

Cuarto paso: Corregir los permisos de los archivos y carpetas

Los permisos incorrectos son otra causa muy común del error 500 PrestaShop. Cada archivo y carpeta tiene una configuración que le dice al servidor quién puede leer, escribir o ejecutar. La configuración estándar y segura es:

Carpetas: Permiso 755.
Archivos: Permiso 644.

Cómo cambiar permisos con Syspanel

En el Administrador de Archivos de Syspanel, navega a la raíz de tu instalación (la carpeta public_html).
Selecciona todos los archivos y carpetas. Puedes usar el botón de seleccionar todo si está disponible.
Haz clic en el botón "Permisos" o "Chmod".
En la ventana que aparece, introduce el valor 755 para las carpetas y 644 para los archivos. La mayoría de los administradores de archivos te permiten aplicar un permiso a todo de forma recursiva, es decir, a todas las subcarpetas y archivos dentro.
Aplica los cambios y espera a que el proceso termine.

[INFO] No te asustes si ves que algunos archivos tienen permisos diferentes. Este cambio masivo es seguro y es el estándar recomendado por PrestaShop.

Quinto paso: Revisar y reparar el archivo settings.inc.php

Este archivo es la llave maestra de tu tienda. Contiene la información para conectarse a la base de datos. Si se ha corrompido o los datos son incorrectos, PrestaShop no puede funcionar.

Verificando la conexión a la base de datos

En el Administrador de Archivos, ve a la carpeta config dentro de tu instalación de PrestaShop.
Busca el archivo settings.inc.php.
Ábrelo y busca las líneas que empiezan por define('_DB_:
- define('_DB_SERVER_', 'localhost'); (o la dirección de tu servidor de base de datos)
- define('_DB_NAME_', 'tu_base_de_datos');
- define('_DB_USER_', 'tu_usuario');
- define('_DB_PASSWD_', 'tu_contraseña');
Verifica que estos datos sean correctos. Puedes comprobarlos en la sección de "Bases de Datos" de Syspanel. Allí verás el nombre de la base de datos, el usuario y podrás restablecer la contraseña.
Si la contraseña ha cambiado, actualiza el valor en el archivo settings.inc.php y guarda los cambios.

[WARNING] Ten muchísimo cuidado al editar este archivo. Un solo carácter mal puesto puede romper toda tu tienda. Si no estás seguro de lo que haces, copia el contenido original en un bloc de notas antes de hacer cambios.

Sexto paso: Desactivar la caché de PrestaShop

La caché es un sistema de almacenamiento temporal que acelera tu tienda. Sin embargo, a veces una caché corrupta puede causar el error 500. Desactivarla puede ser la solución.

Cómo desactivar la caché desde el archivo de configuración

Vuelve al archivo config/settings.inc.php.
Busca la línea que dice define('_PS_CACHE_ENABLED_', '1');.
Cambia el '1' a '0'. Debe quedar así: define('_PS_CACHE_ENABLED_', '0');.
Guarda el archivo.

Desactivando la caché de Smarty

PrestaShop usa un sistema de plantillas llamado Smarty que también tiene su propia caché.

En el Administrador de Archivos, ve a la carpeta var/cache (en versiones antiguas era cache).
Dentro de esta carpeta, hay subcarpetas como dev o prod. Borra todo el contenido de estas carpetas. No borres las carpetas en sí, solo lo que hay dentro.
Si no puedes borrar los archivos, puedes intentar vaciar la carpeta desde el panel de administración de PrestaShop, pero si tienes el error 500, esta opción manual es la mejor.

Séptimo paso: Desactivar módulos problemáticos (si el error persiste)

Si has llegado hasta aquí y el error continúa, es muy probable que un módulo o tema esté causando el conflicto. Para identificarlo, tendrás que hacer una pequeña prueba.

Renombrando la carpeta de módulos

En el Administrador de Archivos, ve a la carpeta de tu instalación de PrestaShop.
Busca la carpeta llamada modules.
Renómbrala a modules_bak. Esto desactivará todos los módulos de golpe.
Intenta acceder a tu tienda. Si el error desaparece, el problema era uno de los módulos.
Ahora, para encontrar al culpable, crea una carpeta nueva llamada modules. Ve moviendo los módulos uno a uno desde modules_bak a la nueva carpeta modules, comprobando tu tienda después de cada movimiento. Cuando el error vuelva a aparecer, habrás encontrado al responsable.

[TIP] Este proceso puede ser tedioso, pero es infalible. Los módulos de pago, envío o los que modifican el front-office suelen ser los más conflictivos.

Octavo paso: Contactar con el soporte de tu hosting

Si después de seguir todos estos pasos el error 500 PrestaShop sigue ahí, es hora de pedir ayuda profesional. El problema podría estar en la configuración del servidor, algo que tú no puedes cambiar desde Syspanel.

Contacta con el soporte técnico de tu proveedor de hosting y dales toda la información que has recopilado: los logs de error, los pasos que has seguido y los cambios que has realizado. Ellos podrán revisar la configuración del servidor a nivel más profundo.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

¿El error 500 en PrestaShop significa que he perdido mis datos?

No, en absoluto. El error 500 es un error de ejecución, no de datos. Tu base de datos y tus productos están a salvo. Es un problema de configuración o de recursos del servidor, no de pérdida de información.

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

Dependiendo de la causa, puede tardar desde 5 minutos (si es un problema de memoria) hasta un par de horas (si tienes que revisar módulos uno a uno). Con esta guía, la mayoría de los casos se resuelven en menos de 30 minutos.

¿Puedo evitar que esto vuelva a pasar?

Sí. Mantén tu PrestaShop siempre actualizado a la última versión. Antes de instalar un módulo nuevo, verifica que sea compatible con tu versión. Y realiza copias de seguridad periódicas de tu base de datos y de tus archivos. Puedes configurar copias de seguridad automáticas desde Syspanel.

¿Qué es exactamente el puerto 2106 de Syspanel?

Es el puerto seguro por defecto para acceder a la interfaz web de Syspanel. Es como la "puerta de entrada" a tu panel de control. Asegúrate de usarlo siempre que quieras gestionar tu hosting.

Conclusión

El error 500 PrestaShop es un contratiempo, pero no es el fin del mundo. Con las herramientas que te ofrece Syspanel, tienes el poder de diagnosticar y solucionar el problema tú mismo. Hemos visto cómo revisar los logs, aumentar la memoria, regenerar el .htaccess, corregir permisos y aislar módulos conflictivos.

Recuerda que la paciencia y el método son tus mejores aliados. Sigue los pasos en orden y no te saltes ninguno. La próxima vez que veas ese temido error, ya sabrás exactamente qué hacer. Tu tienda volverá a estar en línea en un abrir y cerrar de ojos.