Error 500 en PrestaShop con Syspanel | Guía de solución

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

El error 500, también conocido como error interno del servidor, es uno de los más temidos por los usuarios de PrestaShop. Aparece de repente, sin previo aviso, y muestra una pantalla en blanco o un mensaje genérico como "Error interno del servidor". No te preocupes, es un problema común y solucionable.

Este error significa que el servidor web (Apache o Nginx) no puede procesar la solicitud debido a un problema en la configuración, en los archivos de PrestaShop o en los recursos del hosting. Las causas más frecuentes son:

Archivos .htaccess corruptos o mal configurados.
Falta de memoria PHP (límite de memoria excedido).
Módulos o temas incompatibles.
Permisos de archivos incorrectos.
Errores en la configuración de PHP (como tiempo de ejecución o tamaño de subida).

En este artículo, te guiaremos paso a paso para solucionar el error 500 PrestaShop Syspanel usando el panel de control Syspanel (antes conocido como HestiaCP). Recuerda que Syspanel se accede por el puerto 2106 (por ejemplo, https://tudominio.com:2106).

Paso 1: Acceder a Syspanel y revisar los logs de error

Lo primero que debes hacer es identificar la causa exacta del error. Para ello, los logs de error son tu mejor aliado.

1.1. Inicia sesión en Syspanel

Abre tu navegador y escribe: https://tudominio.com:2106
Ingresa con tu usuario y contraseña de hosting.

1.2. Busca los logs de error de PrestaShop

En el menú lateral, ve a "Logs" o "Registros".
Selecciona "Error Log" (Apache/Nginx) o "PHP Error Log".

Busca la fecha y hora en que apareció el error 500. Allí verás líneas como:

[error] PHP Fatal error: Allowed memory size of 134217728 bytes exhausted

[error] PHP Parse error: syntax error, unexpected '}' in /var/www/html/config/config.inc.php

Ejemplo práctico: Si ves un error de memoria, sabrás que necesitas aumentar el límite. Si ves un error de sintaxis, deberás revisar el archivo mencionado.

Paso 2: Soluciones rápidas desde Syspanel

2.1. Aumentar el límite de memoria PHP

Si el log indica "Allowed memory size exhausted", sigue estos pasos:

En Syspanel, ve a "Web" > "PHP Settings" (o "PHP Config").
Busca la opción "memory_limit" y cámbiala a un valor mayor, por ejemplo: 256M o 512M.
Guarda los cambios y reinicia PHP desde el botón "Restart PHP".

[TIP] Si no encuentras la opción, puedes editarlo manualmente en el archivo php.ini desde el administrador de archivos de Syspanel (ruta: /etc/php/versión/apache2/php.ini).

2.2. Verificar y reparar archivos .htaccess

Un archivo .htaccess corrupto es una causa común del error 500.

Accede al Administrador de Archivos de Syspanel (sección "File Manager").
Navega a la raíz de tu sitio PrestaShop (normalmente /home/usuario/web/tudominio/public_html).
Busca el archivo .htaccess. Si existe, renómbralo a .htaccess_backup (esto lo desactiva temporalmente).
Si el error desaparece, el problema está en el .htaccess. Puedes regenerarlo desde el panel de administración de PrestaShop (Ajustes > SEO & URLs > Guardar sin cambios).

2.3. Aumentar el tiempo de ejecución PHP (max_execution_time)

Si el error aparece al instalar un módulo o al hacer una copia de seguridad:

En PHP Settings de Syspanel, busca "max_execution_time" y cámbialo a 300 (5 minutos).
También puedes aumentar "max_input_time" y "upload_max_filesize" si trabajas con archivos grandes.

Paso 3: Solucionar errores de permisos de archivos

Los permisos incorrectos (por ejemplo, archivos con permisos 777 o carpetas con 755 mal asignados) pueden generar el error 500.

3.1. Corregir permisos desde Syspanel

En el Administrador de Archivos, selecciona toda la carpeta public_html.
Haz clic derecho y elige "Change Permissions".
Aplica:
- Carpetas: 755
- Archivos: 644
Marca la opción "Recursive" para aplicar a subcarpetas.

[WARNING] No uses permisos 777 en producción. Solo 755 para carpetas y 644 para archivos. Esto evita vulnerabilidades de seguridad.

3.2. Verificar el propietario de los archivos

En Syspanel, ve a "Web" > "Domain" y selecciona tu dominio.
En "Advanced Options", asegúrate de que el usuario de FTP coincida con el usuario del sistema.
Si no, usa el botón "Repair" o ejecuta el comando chown -R usuario:usuario /home/usuario/web/tudominio/public_html desde la terminal de Syspanel (si tienes acceso SSH).

Paso 4: Desactivar módulos y temas conflictivos

A veces, un módulo o tema recién instalado causa el error 500.

4.1. Desactivar módulos desde la base de datos

Si no puedes acceder al panel de administración de PrestaShop:

En Syspanel, ve a "Databases" y selecciona la base de datos de tu PrestaShop.
Usa phpMyAdmin (integrado en Syspanel) para ejecutar esta consulta SQL:
```
UPDATE ps_module SET active = 0 WHERE id_module = ID_DEL_MODULO;
```
(Reemplaza ID_DEL_MODULO con el número del módulo sospechoso. Puedes obtenerlo del log de errores).

4.2. Cambiar al tema predeterminado

En phpMyAdmin, busca la tabla ps_configuration y localiza PS_THEME_NAME.
Cámbialo a classic (tema por defecto de PrestaShop).

[INFO] Si no sabes qué módulo está fallando, desactiva todos temporalmente con: UPDATE ps_module SET active = 0; Luego, reactívalos uno por uno desde el panel de administración.

Paso 5: Limpiar la caché de PrestaShop

Una caché corrupta puede provocar errores internos. Puedes limpiarla desde Syspanel:

5.1. Eliminar archivos de caché manualmente

En el Administrador de Archivos, ve a /cache/ dentro de la carpeta de PrestaShop.
Elimina todo el contenido de las subcarpetas smarty, cache, y purifier (no borres las carpetas, solo los archivos internos).

5.2. Usar el comando de limpieza desde la terminal (si tienes SSH)

Conéctate por SSH desde Syspanel (sección "SSH").

Ejecuta:

rm -rf /home/usuario/web/tudominio/public_html/var/cache/*

Paso 6: Verificar la configuración de PHP (versión y extensiones)

Una versión de PHP incompatible o extensiones faltantes pueden causar el error 500.

6.1. Cambiar la versión de PHP desde Syspanel

En "Web" > "PHP Settings", selecciona una versión compatible con PrestaShop (recomendamos PHP 7.4 o 8.0, según tu versión de PrestaShop).
Guarda y reinicia PHP.

6.2. Habilitar extensiones necesarias

En la misma sección, activa extensiones como:
- curl
- gd
- mysqli
- openssl
- mbstring
- zip
Si falta alguna, PrestaShop puede mostrar error interno.

[TIP] Puedes verificar las extensiones activas creando un archivo info.php con <?php phpinfo(); ?> y accediendo a él desde el navegador.

Paso 7: Restaurar una copia de seguridad (último recurso)

Si nada funciona, restaura una copia de seguridad reciente.

7.1. Desde Syspanel

Ve a "Backups" y selecciona la copia más reciente de tu sitio.
Haz clic en "Restore" y sigue las instrucciones.

7.2. Restauración manual

Descarga el backup desde "File Manager" o "Databases".
Sube los archivos nuevamente y restaura la base de datos con phpMyAdmin.

[WARNING] La restauración sobrescribirá todos los datos actuales. Asegúrate de tener una copia de seguridad actualizada antes de hacer cambios.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error 500 después de actualizar PrestaShop?

Las actualizaciones pueden cambiar archivos de configuración o requerir nuevas extensiones PHP. Revisa los logs y asegúrate de que tu versión de PHP sea compatible.

¿Puedo solucionar el error 500 sin acceso al panel de administración?

Sí, con Syspanel puedes acceder a los archivos, la base de datos y los logs directamente. Sigue los pasos anteriores.

¿El error 500 afecta el SEO?

Sí, porque Google no puede indexar tu sitio si está caído. Soluciona el error lo antes posible para evitar penalizaciones.

¿Cómo evito que vuelva a aparecer?

Mantén PrestaShop y los módulos actualizados.
Realiza copias de seguridad periódicas.
Monitorea los logs de error semanalmente desde Syspanel.
No instales módulos de fuentes no confiables.

Conclusión

El error 500 en PrestaShop puede ser frustrante, pero con Syspanel tienes todas las herramientas para resolverlo rápidamente. Recuerda:

Revisa los logs de error.
Aumenta la memoria PHP y el tiempo de ejecución.
Corrige permisos y .htaccess.
Desactiva módulos conflictivos.
Limpia la caché.
Ajusta la versión de PHP.

Si sigues estos pasos, en la mayoría de los casos el error desaparecerá. Si persiste, contacta a tu proveedor de hosting con los logs en mano. ¡No dejes que un error 500 arruine tu tienda online!

[INFO] Syspanel (puerto 2106) es tu aliado para gestionar tu hosting de forma sencilla. Aprovecha sus herramientas de logs, archivos y base de datos para mantener tu PrestaShop saludable.