Solucionar error 500 en PrestaShop | Guía para cPanel, Plesk y DirectAdmin

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a enfrentarnos a uno de los errores más temidos en el mundo del comercio electrónico: el temido error 500 en PrestaShop. También conocido como error interno del servidor, puede aparecer de repente y dejarte sin tienda. Pero no te preocupes, porque voy a guiarte paso a paso para solucionarlo en los paneles de control más comunes: cPanel, Plesk, DirectAdmin y también Syspanel (antes conocido como HestiaCP, que se accede por el puerto 2106). Vamos a desglosar las causas más frecuentes y cómo resolverlas, incluso si no eres un experto técnico.

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

El error 500 es un código de estado HTTP que indica que algo salió mal en el servidor, pero sin dar detalles específicos al usuario. En PrestaShop, suele estar relacionado con:

Archivos de configuración corruptos (como .htaccess o settings.inc.php).
Módulos incompatibles o mal instalados.
Problemas de permisos de archivos o carpetas.
Falta de memoria o límites de PHP excedidos.
Conflictos con la versión de PHP o extensiones faltantes.

No te asustes: la mayoría de las veces se soluciona con unos pocos pasos. Vamos a empezar.

Primeros pasos: antes de tocar nada

Antes de entrar en pánico, haz esto:

Limpia la caché del navegador y prueba en modo incógnito.
Revisa si el error es general (toda la web) o solo en una página (por ejemplo, al añadir un producto al carrito).
Accede al panel de administración de PrestaShop (si puedes). Si el error te bloquea el acceso, tendrás que trabajar directamente desde el panel de control del hosting.

Si el error persiste, vamos a la acción.

Solucionar error 500 en cPanel

cPanel es uno de los paneles más populares. Sigue estos pasos:

1. Activar el modo debug de PrestaShop

El modo debug te mostrará el error real, no solo "500". Edita el archivo config/defines.inc.php en la raíz de tu tienda:

Busca la línea: define('_PS_MODE_DEV_', false);
Cámbiala a: define('_PS_MODE_DEV_', true);

[WARNING] No dejes esto activado en producción. Una vez solucionado el error, vuelve a ponerlo en false.

2. Revisar el archivo .htaccess

A veces el .htaccess se corrompe al instalar módulos o cambiar configuraciones. Para regenerarlo:

Accede a cPanel > Administrador de archivos.
Ve a la carpeta de tu tienda (ej: public_html).
Renombra el archivo .htaccess a .htaccess_old (esto lo desactiva).
Ve a tu tienda: si funciona, el problema era el .htaccess. Entra al back office de PrestaShop y ve a Configuración > Rendimiento > Regenerar archivo .htaccess.

3. Verificar permisos de archivos

Los permisos incorrectos causan errores 500. En cPanel:

Selecciona toda la carpeta de tu tienda.
Haz clic en Permisos y establece:
- Carpetas: 755
- Archivos: 644
No olvides la carpeta config y cache: deben tener permisos 755.

[TIP] No uses 777 en producción por seguridad. Solo temporalmente si es necesario.

4. Aumentar el límite de memoria PHP

Si tu tienda tiene muchos productos o módulos, puede superar el límite de memoria. En cPanel:

Ve a Seleccionar versión de PHP (o MultiPHP Manager).
Haz clic en Opciones y cambia memory_limit a 256M o más (ej: 512M).
Guarda y prueba.

Solucionar error 500 en Plesk

Plesk es común en servidores Windows y Linux. Los pasos son similares pero con su interfaz.

1. Activar logs de errores

En Plesk, los logs están en Sitios web y dominios > [tu dominio] > Logs. Busca el archivo error_log o php_error.log para ver el mensaje exacto.

2. Desactivar módulos problemáticos

Si el error apareció tras instalar un módulo:

Accede a Archivos en Plesk.
Ve a modules dentro de tu tienda.
Renombra la carpeta del módulo sospechoso (ej: mimodulo_old).
Si la tienda vuelve a funcionar, ese módulo es el culpable. Desinstálalo desde el back office (si puedes acceder).

3. Revisar la versión de PHP

PrestaShop 1.6 funciona con PHP 5.6-7.1; PrestaShop 1.7 y 8 requieren PHP 7.1+ (recomendado 7.4 u 8.0). En Plesk:

Ve a Sitios web y dominios > [tu dominio] > PHP Settings.
Cambia la versión de PHP a una compatible (ej: 7.4).
Guarda y limpia la caché.

4. Forzar regeneración de caché

En Plesk, puedes eliminar la caché manualmente:

Ve a Archivos y borra todo el contenido de la carpeta cache (excepto el archivo index.php).
También borra cache/smarty/cache y cache/smarty/compile.

Solucionar error 500 en DirectAdmin

DirectAdmin es otro panel común, especialmente en servidores Linux. Vamos paso a paso.

1. Verificar el error en los logs

En DirectAdmin, los logs están en Panel de control > Log Viewer o directamente en la carpeta del dominio: domains/tudominio.com/logs/error.log. Busca la línea que diga "PHP Fatal error".

2. Comprobar el archivo settings.inc.php

Este archivo en config/settings.inc.php contiene la conexión a la base de datos. Si está dañado:

Descarga una copia de seguridad de tu base de datos.
Reemplaza el archivo con una versión limpia (puedes copiarlo de una instalación nueva de PrestaShop de la misma versión).
Edítalo con los datos de tu BD (servidor, usuario, contraseña, nombre de BD).

[INFO] Si no tienes backup, contacta con tu hosting. Nunca edites este archivo sin saber lo que haces.

3. Deshabilitar módulos por FTP

Si no puedes acceder al back office, usa FTP:

Conéctate con FileZilla o similar.
Ve a /modules/ y renombra la carpeta del módulo sospechoso (ej: mimodulo a mimodulo_desactivado).
Prueba la tienda. Si funciona, ya sabes cuál es.

4. Ajustar límites de PHP en DirectAdmin

En Panel de control > PHP Settings (o en php.ini personalizado):

Aumenta memory_limit a 256M.
Aumenta max_execution_time a 120.
Aumenta upload_max_filesize a 64M.

Guarda y reinicia el servicio PHP (a veces lo hace automáticamente).

Solucionar error 500 en Syspanel (HestiaCP, puerto 2106)

Syspanel es una alternativa moderna y ligera. Recuerda que se accede por https://tudominio.com:2106. Los pasos son similares a los anteriores, pero con su interfaz.

1. Acceder a los logs

En Syspanel, ve a WEB > [tu dominio] > Logs. Allí verás el error exacto. Si no aparece, revisa /var/log/ en el servidor (vía SSH, si tienes acceso).

2. Regenerar el .htaccess desde Syspanel

Syspanel no tiene un botón directo, pero puedes hacerlo manualmente:

Ve a WEB > [tu dominio] > Archivos.
Renombra .htaccess a .htaccess.bak.
Luego, desde el back office de PrestaShop (si puedes acceder), regenera el archivo.

3. Verificar la versión de PHP

En Syspanel, ve a WEB > [tu dominio] > Configuración avanzada y cambia la versión de PHP. PrestaShop 1.7+ necesita al menos PHP 7.1. Si tu hosting lo permite, usa PHP 8.0 o 8.1 (pero verifica compatibilidad de módulos).

4. Aumentar memoria PHP en Syspanel

En la misma sección de configuración avanzada, busca PHP Settings y ajusta:

memory_limit = 256M
max_execution_time = 120
post_max_size = 64M

Guarda y recarga la tienda.

Causas comunes y soluciones rápidas (FAQ)

Aquí tienes un resumen de las preguntas más frecuentes:

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

Los módulos desactualizados o incompatibles con la versión de PHP pueden romper la tienda. Desactívalos por FTP (renombrando la carpeta) y luego actualiza desde el back office.

¿El error 500 puede deberse a la base de datos?

Sí, si la tabla ps_configuration está corrupta o hay un problema de conexión. Revisa los logs y, si ves errores de MySQL, repara las tablas desde phpMyAdmin.

¿Cómo saber si es un problema de permisos?

Si ves errores como "Permission denied" en los logs, entonces sí. Aplica los permisos 755 en carpetas y 644 en archivos, como explicamos antes.

¿Qué hago si no puedo acceder al back office?

Usa FTP o el administrador de archivos de tu panel. Renombra la carpeta modules a modules_old (esto desactiva todos los módulos). Si la tienda funciona, reactiva uno por uno hasta encontrar el culpable.

¿El error 500 puede ser por falta de espacio en disco?

Sí, si el disco está lleno, el servidor no puede escribir archivos temporales. Revisa el espacio en tu panel de control y libera si es necesario.

Consejos finales para evitar el error 500 en el futuro

Mantén PrestaShop actualizado (tanto la versión principal como los módulos).
Haz backups periódicos de archivos y base de datos.
Usa un entorno de pruebas antes de instalar módulos o hacer cambios grandes.
No instales módulos de fuentes no oficiales (pueden tener código malicioso o ser incompatibles).
Configura un límite de memoria PHP generoso (256M o más) desde el principio.

[TIP] Si después de todo esto el error persiste, contacta con tu proveedor de hosting. Puede ser un problema del servidor (como un error de configuración de Apache/Nginx o un firewall bloqueando algo).

Espero que esta guía te haya sido de ayuda. Recuerda que el error 500 en PrestaShop no es el fin del mundo; con paciencia y siguiendo estos pasos, lo solucionarás. ¡Buena suerte con tu tienda!