Solucionar error 500 en PrestaShop: guía para cPanel y WordPress

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

El error 500 en PrestaShop es un mensaje genérico de "Error interno del servidor". Esto significa que algo salió mal en el servidor web al intentar cargar tu tienda, pero no se da un detalle específico. Puede aparecer en todo el sitio o solo en ciertas páginas, como el panel de administración o el checkout.

Las causas más comunes incluyen: archivos de configuración corruptos, problemas con módulos o temas, límites de memoria PHP insuficientes, errores en el archivo .htaccess, o conflictos con la versión de PHP. No te preocupes, en la mayoría de los casos se puede resolver siguiendo pasos sencillos.

[INFO] Si ves el error 500 solo en algunas páginas (por ejemplo, al guardar un producto), el problema suele estar en un módulo o tema específico. Si es en todo el sitio, revisa primero los archivos de configuración.

Pasos previos: prepara tu entorno de trabajo

Antes de empezar a solucionar el error, asegúrate de tener acceso a:

cPanel (o Syspanel, como se menciona en este artículo) con credenciales de administrador.
Acceso FTP o al administrador de archivos del panel de control.
Copia de seguridad reciente de tu tienda y base de datos. Esto es clave por si algo sale mal.

[WARNING] Siempre haz una copia de seguridad completa antes de modificar archivos o configuraciones. Un error puede dejar tu tienda inaccesible.

Si usas Syspanel (el panel que antes se llamaba HestiaCP), recuerda que el puerto de acceso es el 2106. Por ejemplo: https://tudominio.com:2106.

Paso 1: Activar el modo debug de PrestaShop para ver el error real

PrestaShop tiene un modo de depuración (debug) que muestra el error específico en lugar del genérico 500. Esto te dará pistas claras.

Cómo activar el debug en PrestaShop

Accede a tu panel de control (cPanel o Syspanel) y abre el Administrador de archivos o conéctate por FTP.
Navega hasta la carpeta raíz de tu tienda (normalmente public_html o www).
Busca el archivo config/defines.inc.php.
Ábrelo con un editor de texto (como el editor de cPanel).
Busca la línea:
define('_PS_MODE_DEV_', false);
Cámbiala a:
define('_PS_MODE_DEV_', true);
Guarda el archivo.

Ahora, al recargar tu tienda, verás un mensaje de error detallado en lugar del 500. Anota el error (por ejemplo, "Fatal error: Allowed memory size exhausted" o "Class not found").

[TIP] Si no ves ningún cambio, verifica que el archivo se haya guardado correctamente. También puedes agregar estas líneas justo después de la anterior para más detalles:
ini_set('display_errors', 'on');
define('_PS_DISPLAY_COMPRESSION', false);

¿Y si no puedo acceder al administrador de archivos?

Si el error 500 te impide incluso entrar al panel de control, puedes activar el debug desde la base de datos:

Accede a phpMyAdmin desde cPanel (o Syspanel).
Selecciona la base de datos de tu tienda.
Ve a la tabla ps_configuration (el prefijo puede variar; busca configuration).
Busca la fila con name = PS_MODE_DEV.
Cambia su value a 1.
Guarda los cambios.

Paso 2: Solucionar el error 500 PrestaShop según el mensaje de debug

Una vez tengas el mensaje de error, actúa según el caso:

Caso A: Error de memoria PHP (Allowed memory size)

Si ves algo como "Allowed memory size of X bytes exhausted", tu tienda necesita más memoria.

Cómo solucionarlo en cPanel:

Ve a Seleccionar versión de PHP (o MultiPHP Manager).
Busca la opción memory_limit y ajústala a un valor más alto, por ejemplo 256M o 512M.
Guarda los cambios.

En Syspanel (HestiaCP):

Accede a Syspanel por el puerto 2106.
Ve a Configuración de PHP para tu dominio.
Cambia memory_limit a 256M o más.
Guarda y reinicia el servicio web.

Si no puedes cambiarlo desde el panel, edita el archivo .htaccess en la raíz y agrega:

php_value memory_limit 256M

[WARNING] No excedas los límites de tu plan de hosting. Si necesitas más de 512M, contacta a tu proveedor.

Caso B: Error de clase no encontrada (Class not found)

Esto suele ocurrir por un módulo o tema corrupto, o porque falta un archivo.

Pasos para resolverlo:

Desde el mensaje de error, identifica el nombre de la clase (ej: ModuleClass).
Desactiva temporalmente todos los módulos no esenciales:
- Renombra la carpeta modules a modules_backup (desde FTP o administrador de archivos).
- Crea una carpeta nueva llamada modules vacía.
Si el error desaparece, el problema está en uno de los módulos. Actívalos de uno en uno para encontrar el culpable.
Si el error persiste, prueba con el tema por defecto (renombra la carpeta themes a themes_backup y crea una vacía). Luego reinstala el tema original.

Caso C: Error en el archivo .htaccess

Un .htaccess corrupto puede causar el error 500.

Solución:

Desde el administrador de archivos, renombra .htaccess a .htaccess_backup.
Recarga tu tienda. Si funciona, el archivo estaba dañado.
Ve al panel de administración de PrestaShop (si puedes acceder) y ve a Configuración > SEO y URL.
Haz clic en Guardar para regenerar el .htaccess automáticamente.

Si no puedes acceder al panel, crea un nuevo .htaccess con el contenido básico:

# START PrestaShop
<IfModule mod_rewrite.c>
RewriteEngine on
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php [QSA,L]
</IfModule>
# END PrestaShop

Paso 3: Verificar la versión de PHP y los requisitos de PrestaShop

PrestaShop requiere una versión específica de PHP. Si usas una muy antigua o muy nueva, puede dar error 500.

Versiones recomendadas:

PrestaShop 1.7: PHP 7.1 a 7.4 (mejor 7.4).
PrestaShop 8.x: PHP 7.4 a 8.1.

Cómo cambiarlo en cPanel:

Ve a Seleccionar versión de PHP.
Elige una versión compatible.
Guarda.

En Syspanel:

Accede por el puerto 2106.
Ve a Configuración de PHP.
Cambia la versión y guarda.

[INFO] Si tu hosting no soporta la versión necesaria, contacta al soporte técnico. Algunos proveedores ofrecen versiones antiguas solo bajo solicitud.

Paso 4: Revisar los permisos de archivos y carpetas

Los permisos incorrectos pueden impedir que PrestaShop lea o escriba archivos, causando el error 500.

Permisos correctos:

Carpetas: 755 (rwxr-xr-x)
Archivos: 644 (rw-r--r--)

Cómo corregirlos desde cPanel:

En el administrador de archivos, selecciona toda la carpeta raíz.
Haz clic en Permisos.
Marca las casillas adecuadas (lectura/escritura para el propietario, solo lectura para grupo y otros).
Aplica a todas las subcarpetas y archivos.

También puedes usar FTP: selecciona todo y cambia los permisos en lote.

Paso 5: Probar con un tema por defecto y módulos básicos

A veces, el error 500 es causado por un tema o módulo de terceros.

Cambia al tema predeterminado: Si usas un tema personalizado, cambia temporalmente al tema "Classic" o "default-bootstrap".
Desactiva todos los módulos no esenciales: desde el panel de administración (si puedes acceder) o renombrando la carpeta modules.
Prueba uno por uno: reactiva los módulos hasta encontrar el conflicto.

Cuándo contactar al soporte técnico de hosting

Si después de todos estos pasos el error 500 en PrestaShop persiste, puede ser un problema del servidor que solo el proveedor puede resolver. Contacta a tu soporte técnico y diles:

El mensaje de error exacto del modo debug.
Los pasos que ya realizaste.
La versión de PrestaShop y PHP que usas.

[TIP] Cuando hables con soporte, menciona que ya activaste el debug y que el error es específico (ej: "Fatal error: Allowed memory size"). Esto les ahorrará tiempo.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

¿El error 500 puede dañar mis datos?

No, el error 500 no corrompe la base de datos ni los archivos. Solo impide que la tienda se muestre. Sin embargo, al hacer cambios para solucionarlo, siempre ten una copia de seguridad.

¿Por qué aparece solo en el panel de administración?

Suele ser por un módulo o tema incompatible con la versión de PrestaShop, o por un error en la configuración de PHP (como memoria insuficiente).

¿Puedo solucionarlo sin acceso al panel de control?

Sí, usando FTP o el administrador de archivos de tu hosting. También puedes modificar la base de datos desde phpMyAdmin para activar el debug.

¿Qué hago si el error aparece después de una actualización?

Vuelve a la versión anterior de PrestaShop o de los módulos actualizados. Si no tienes copia, contacta al soporte del módulo o tema.

¿Syspanel (HestiaCP) tiene alguna configuración especial?

Sí, recuerda que el puerto de acceso es el 2106. La configuración de PHP y los permisos se manejan de manera similar a cPanel, pero desde la interfaz de Syspanel.

Resumen final

El error 500 en PrestaShop es frustrante pero casi siempre solucionable. Sigue estos pasos en orden:

Activa el modo debug para ver el error real.
Ajusta la memoria PHP si es necesario.
Revisa el archivo .htaccess.
Verifica la versión de PHP.
Corrige permisos de archivos.
Prueba con el tema y módulos por defecto.

Si nada funciona, tu proveedor de hosting es tu mejor aliado. Con paciencia y estos pasos, tu tienda volverá a funcionar en poco tiempo.

[WARNING] No olvides desactivar el modo debug una vez solucionado el error. Vuelve a cambiar _PS_MODE_DEV_ a false en config/defines.inc.php para evitar que los visitantes vean mensajes técnicos.