Cómo solucionar error 500 en PrestaShop con Syspanel

¡Hola! Si estás leyendo esto, probablemente te has encontrado con la temida pantalla en blanco o el mensaje "Error 500 Internal Server Error" en tu tienda PrestaShop. No te preocupes, es uno de los errores más comunes y, con esta guía paso a paso, podrás solucionarlo usando tu panel de control Syspanel (accesible desde tu navegador en el puerto 2106). Vamos a desglosar todo lo que necesitas saber para que tu tienda vuelva a funcionar.

¿Qué es un error 500 en PrestaShop y por qué ocurre?

Un error 500 es un error genérico del servidor. Básicamente, significa que algo salió mal en el servidor web (Apache o Nginx) o en el propio PHP que ejecuta PrestaShop, pero el sistema no puede darte un mensaje más específico. Las causas más frecuentes son:

Un módulo o tema conflictivo: Algo que instalaste recientemente está causando un bloqueo.
Problemas de permisos de archivos: PrestaShop necesita ciertos permisos para escribir en carpetas como cache, log o config.
Límite de memoria PHP excedido: Tu tienda necesita más memoria de la que tiene asignada.
Archivos corruptos o incompletos: Una actualización fallida o una subida de archivos incompleta.
Errores en el archivo .htaccess: Una regla mal escrita puede romper todo.

[INFO] El error 500 es "silencioso" a propósito por seguridad. No muestra detalles al usuario para no exponer información sensible. Por eso, necesitamos activar los logs para ver la causa real.

Paso 1: Accede a Syspanel y activa los logs de PHP

Lo primero es ver qué está fallando realmente. Para ello, activaremos el registro de errores de PHP desde Syspanel.

Abre tu navegador y ve a https://tudominio.com:2106 (o la IP de tu servidor). Inicia sesión con tus credenciales de Syspanel.
Una vez dentro, busca la sección "Web" o "Dominios" y haz clic en tu dominio.
Dentro de la configuración del dominio, busca la pestaña "Avanzado" o "Opciones PHP".
Aquí verás una opción llamada "Modo de error PHP" o "Display Errors". Cámbiala a "On" o "Activo".
También asegúrate de que "Log de errores" esté activado. Normalmente se guarda en una ruta como /home/usuario/logs/dominio.error.log.
Guarda los cambios.

Ahora, recarga tu tienda. En lugar de la pantalla en blanco, verás un mensaje de error específico (por ejemplo, "Fatal error: Allowed memory size exhausted..."). ¡Eso es oro puro!

[WARNING] No dejes los errores visibles para siempre. Una vez resuelto el problema, vuelve a Syspanel y desactiva "Display Errors" por seguridad.

Paso 2: Identifica el error en los logs del servidor

Si no ves el error en pantalla o prefieres un registro más completo, revisa los logs de Syspanel.

En Syspanel, ve a la sección "Logs" o "Registros".
Busca el archivo de log de errores de tu dominio (suele llamarse error.log o dominio.error.log).
Abre ese archivo. Busca las últimas líneas que aparecen justo después de que intentaste cargar tu tienda. Verás algo como:
```
[20-Oct-2023 10:30:15 UTC] PHP Fatal error:  Allowed memory size of 134217728 bytes exhausted (tried to allocate 20480 bytes) in /home/usuario/public_html/config/config.inc.php on line 45
```
Este mensaje te dice exactamente qué archivo y línea causan el problema. Anótalo.

Paso 3: Soluciones rápidas para el error 500 en PrestaShop

Dependiendo de lo que diga el log, aplica una de estas soluciones:

Solución A: Aumentar el límite de memoria PHP

Si el error dice "Allowed memory size exhausted", necesitas más memoria.

En Syspanel, dentro de la configuración de tu dominio (paso 1), busca "Memory Limit" o "Límite de memoria".
Auméntalo a 256M o incluso 512M si tu hosting lo permite.
Guarda y recarga la tienda.

Solución B: Deshabilitar un módulo o tema problemático

Si el error apunta a un módulo (por ejemplo, /modules/mimodulo/mimodulo.php), la solución más rápida es deshabilitarlo desde el panel de administración. Pero si el error 500 te impide acceder al panel, hazlo manualmente:

Conéctate a tu servidor por FTP o desde el administrador de archivos de Syspanel (sección "Archivos").
Ve a la carpeta public_html/modules/.
Busca la carpeta del módulo problemático (por ejemplo, mimodulo).
Renómbrala a algo como mimodulo_old. Esto obliga a PrestaShop a desactivarlo.
Si el problema es un tema, ve a public_html/themes/ y renombra la carpeta del tema activo (por ejemplo, tema_activo_old). PrestaShop usará el tema por defecto.

[TIP] Si no sabes qué módulo es, renombra todos los módulos recién instalados (uno por uno) hasta que la tienda funcione.

Solución C: Corregir permisos de archivos y carpetas

PrestaShop necesita permisos específicos. Los más seguros suelen ser:

Archivos: 644
Carpetas: 755

Desde Syspanel, puedes usar el administrador de archivos:

Ve a la raíz de tu web (normalmente public_html).
Selecciona todas las carpetas y archivos (Ctrl+A).
Haz clic en "Permisos" y establece 755 para carpetas y 644 para archivos.
Asegúrate de que las carpetas cache, log, config, upload, download, sitemap y translations tengan permisos 777 temporalmente para que PrestaShop pueda escribir. Luego devuélvelos a 755.

Solución D: Regenerar el archivo .htaccess

Un .htaccess corrupto puede dar error 500.

Desde el administrador de archivos de Syspanel, localiza el archivo .htaccess en la raíz de tu web.
Renómbralo a .htaccess_old.
Ahora, intenta acceder a tu tienda. Si funciona, el problema era ese archivo.
Ve al panel de administración de PrestaShop (Back Office) > Parámetros de la tienda > Tráfico y SEO.
Sin cambiar nada, haz clic en "Guardar". Esto regenerará un .htaccess limpio.

Paso 4: Soluciones avanzadas (si nada funciona)

Si los pasos anteriores no resuelven el error 500 en PrestaShop, prueba lo siguiente:

4.1. Aumentar el tiempo de ejecución de PHP

Algunos procesos (como importar productos) necesitan más tiempo.

En Syspanel, busca "Max Execution Time" y ponlo a 300 (segundos).

4.2. Revisar la versión de PHP

PrestaShop 1.6 funciona bien con PHP 5.6 o 7.0, pero PrestaShop 1.7 y 8.x necesitan PHP 7.1 o superior (recomendado PHP 8.0 o 8.1).

En Syspanel, en la configuración del dominio, busca "Versión de PHP" y selecciona la adecuada.

4.3. Verificar la integridad de los archivos del núcleo

Si sospechas que un archivo central está dañado:

Descarga una copia limpia de PrestaShop desde la página oficial (misma versión que la tuya).
Descomprime en tu PC.
Sube solo la carpeta admin (renómbrala como la tuya) y la carpeta install (si no la tienes, créala vacía) por FTP, sin sobrescribir archivos de módulos o temas.
También puedes subir los archivos index.php de las carpetas raíz y config/.

[WARNING] Nunca subas el archivo settings.inc.php de la copia limpia, porque borraría tu configuración de base de datos.

FAQ: Preguntas frecuentes sobre el error 500 en PrestaShop

P: ¿Puedo perder datos al solucionar el error 500?
R: No, si solo modificas archivos de configuración o renombras módulos. Siempre es recomendable hacer una copia de seguridad de la base de datos y los archivos antes de cualquier cambio importante. Syspanel tiene una herramienta de backup en la sección "Backup".

P: ¿El error 500 puede deberse a un problema de base de datos?
R: Sí, aunque es menos común. Si el log menciona "PDOException" o "MySQL", puede que la base de datos esté corrupta o haya excedido su límite. En Syspanel, ve a "Base de datos" y repara las tablas con la opción "Reparar".

P: ¿Qué hago si no puedo acceder ni al Back Office de PrestaShop?
R: Usa siempre Syspanel o FTP para hacer cambios manuales. Puedes deshabilitar módulos renombrando sus carpetas, o cambiar la contraseña de administrador directamente en la base de datos desde Syspanel (sección "phpMyAdmin").

P: ¿Syspanel me permite ver los logs en tiempo real?
R: Sí. En la sección "Logs" de Syspanel, puedes ver el archivo de errores y actualizarlo manualmente. También puedes usar el comando tail -f desde el terminal de Syspanel (si tienes acceso SSH).

P: Después de solucionar el error 500, ¿debo hacer algo más?
R: Sí. Vuelve a Syspanel y desactiva la visualización de errores PHP (Display Errors). También borra la carpeta cache de PrestaShop (excepto el archivo index.php) para forzar la regeneración de archivos temporales.

Resumen rápido para solucionar error 500 en PrestaShop

Activa los logs desde Syspanel (puerto 2106).
Lee el error en el log o en pantalla.
Aplica la solución según el error:
- Memoria: Aumenta el límite en Syspanel.
- Módulo: Renombra la carpeta del módulo.
- Permisos: Pon 755/644.
- .htaccess: Renómbralo y regenera.
Prueba la tienda.
Desactiva los logs cuando todo funcione.

Recuerda que en Syspanel tienes todas las herramientas necesarias para gestionar tu servidor y tu tienda PrestaShop. Si el error persiste después de todo esto, contacta con tu proveedor de hosting, ya que puede ser un problema de configuración del servidor (como un límite de recursos demasiado bajo).

¡Esperamos que esta guía te haya sido de ayuda! No dudes en dejar tus dudas en los comentarios.