Error 500 en PrestaShop: causas y soluciones en cPanel y Plesk

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, es porque probablemente te has topado con el temido error 500 en PrestaShop o la aún más frustrante pantalla blanca de PrestaShop. No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía te voy a explicar paso a paso cómo solucionar error 500 tanto si usas cPanel como Plesk (y también mencionaré Syspanel). Vamos a ello.

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

El error 500 es un error genérico del servidor. Básicamente, significa que algo falló en el servidor web al intentar cargar tu tienda PrestaShop, pero no da detalles específicos. Las causas más habituales son:

Un archivo .htaccess corrupto o mal configurado.
Problemas de permisos en archivos o carpetas.
Un módulo o tema defectuoso que rompe la tienda.
Límite de memoria PHP excedido (memory_limit).
Conflictos con la versión de PHP.
Errores en el archivo de configuración (settings.inc.php o parameters.php).

No te asustes. Vamos a atacar cada posible causa una por una.

Antes de empezar: activa el modo debug de PrestaShop

Para ver el error real detrás de la pantalla blanca, lo mejor es activar el modo de depuración. Esto te mostrará el mensaje de error exacto (por ejemplo, un "Call to undefined function" o un "Allowed memory size exhausted").

### En cPanel

Accede al Administrador de archivos de cPanel.
Ve a la carpeta raíz de tu tienda (normalmente public_html o una subcarpeta).
Busca el archivo config/defines.inc.php.

Edítalo y busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda los cambios. Ahora al cargar la tienda verás errores detallados en lugar de la pantalla blanca.

### En Plesk

Ve a Archivos en el panel de tu dominio.
Navega a httpdocs o la carpeta donde esté instalado PrestaShop.
Edita el archivo config/defines.inc.php igual que en cPanel.
Guarda y recarga la tienda.

[TIP] Si no ves el error después de esto, revisa el log de errores de PHP (suele estar en var/logs o en el panel de hosting).

Paso 1: Verificar y regenerar el archivo .htaccess

El archivo .htaccess de PrestaShop es muy sensible. Un cambio mínimo puede provocar el error 500.

### Solución rápida en cPanel y Plesk

Renombra temporalmente el archivo .htaccess a .htaccess_backup (desde el administrador de archivos o FTP).
Carga tu tienda. Si funciona, el problema está en ese archivo.
Para regenerarlo, ve al Back Office de PrestaShop > Parámetros de la tienda > Tráfico y SEO.
Sin cambiar nada, haz clic en Guardar (esto regenera el .htaccess automáticamente).

[WARNING] Si no puedes acceder al Back Office, descarga el .htaccess de una instalación limpia de PrestaShop (misma versión) y súbelo a la raíz. Luego ajusta la URL manualmente.

Paso 2: Ajustar los permisos de archivos y carpetas

Los permisos incorrectos son una causa muy común. PrestaShop necesita permisos específicos para funcionar.

### En cPanel

Ve al Administrador de archivos.
Selecciona todos los archivos y carpetas de la raíz.
Haz clic en Permisos.
Establece 755 para carpetas y 644 para archivos.
No marques "Recursivo" a menos que sepas lo que haces (puede ser lento). Mejor hazlo manualmente en las carpetas clave: config, cache, log, img, mails, modules, themes, translations, upload, download.

### En Plesk

Ve a Archivos > Panel de archivos.
Selecciona la carpeta raíz.
Usa la opción Cambiar permisos.
Aplica 755 a carpetas y 644 a archivos.

[INFO] No te obsesiones con cada archivo. Si el error persiste, concéntrate en las carpetas config y cache. A veces basta con dar permisos 777 temporalmente a config/xml y cache para que PrestaShop pueda escribir, pero luego vuelve a 755 por seguridad.

Paso 3: Aumentar el límite de memoria PHP

Si tu tienda tiene muchos productos o módulos pesados, puede exceder el límite de memoria.

### En cPanel

Ve a Seleccionar versión de PHP (o MultiPHP Manager).
Haz clic en Opciones o Switch to PHP Options.
Busca memory_limit y cámbialo a 256M o 512M.
También ajusta max_execution_time a 300 y max_input_vars a 5000.
Guarda.

### En Plesk

Ve a PHP Settings dentro de tu dominio.
Busca memory_limit y ajústalo.
Guarda los cambios.

[TIP] Si no encuentras estas opciones, puedes crearlas manualmente en un archivo php.ini en la raíz (si tu hosting lo permite) o mediante un .user.ini en la raíz de PrestaShop.

Paso 4: Deshabilitar módulos y temas problemáticos

A veces un módulo o tema recién instalado o actualizado rompe la tienda.

### Si aún tienes acceso al Back Office

Ve a Módulos > Gestor de módulos.
Deshabilita todos los módulos no esenciales, especialmente los que hayas instalado recientemente.
Cambia temporalmente a un tema por defecto (por ejemplo, Classic).
Si el error desaparece, reactiva los módulos uno por uno para identificar el culpable.

### Si no tienes acceso (pantalla blanca total)

Conéctate por FTP o al administrador de archivos.
Ve a la carpeta modules.
Renombra la carpeta del módulo sospechoso añadiendo _old al final (por ejemplo, supermodulo_old).
Prueba la tienda. Si funciona, ese módulo es el problema. Elimínalo o actualízalo.

[WARNING] No borres módulos nativos de PrestaShop (como ps_mainmenu, ps_searchbar, etc.) a menos que estés seguro.

Paso 5: Revisar la versión de PHP

PrestaShop 1.7 necesita PHP 7.1 o superior (idealmente 7.4 u 8.0). Las versiones antiguas (1.6) funcionan con PHP 5.6 o 7.0.

### En cPanel

Ve a Seleccionar versión de PHP.
Elige una versión compatible con tu PrestaShop (consulta los requisitos oficiales).
Guarda.

### En Plesk

Ve a PHP Settings.
Cambia la versión de PHP desde el desplegable.

[INFO] Si usas Syspanel (antes HestiaCP), recuerda que el puerto de acceso es el 2106. Allí también puedes cambiar la versión de PHP desde el panel de dominio.

Paso 6: Forzar la regeneración de la caché

La caché corrupta puede dar errores 500.

### Manualmente (sin acceso a Back Office)

Conéctate por FTP o administrador de archivos.
Borra todo el contenido de la carpeta cache/smarty/compile (no borres la carpeta en sí, solo los archivos de dentro).
También borra el contenido de cache/smarty/cache.
Opcional: borra el archivo config/xml/themes.xml (se regenerará solo).

### Desde Back Office (si puedes acceder)

Ve a Parámetros avanzados > Rendimiento.
Haz clic en Forzar compilación y luego en Guardar.
Después, desactiva Forzar compilación y guarda de nuevo.

Paso 7: Verificar el archivo settings.inc.php

Este archivo contiene la configuración de la base de datos. Si está dañado, todo falla.

Abre el archivo config/settings.inc.php (o app/config/parameters.php en PrestaShop 1.7+).
Verifica que los datos de conexión a la base de datos sean correctos (servidor, usuario, contraseña, nombre de BD).
Si todo parece bien, puedes hacer una copia de seguridad y luego renombrarlo para forzar a PrestaShop a regenerarlo (esto es extremo, mejor hazlo solo si sabes lo que haces y tienes backup).

[WARNING] No modifiques este archivo si no estás seguro. Un error puede dejar tu tienda inaccesible.

Paso 8: Contacta con tu proveedor de hosting

Si después de todos estos pasos el error 500 persiste, el problema puede ser del servidor (por ejemplo, un límite de recursos muy bajo, un firewall bloqueando algo, o un error en la configuración de Apache/Nginx). En ese caso:

Abre un ticket de soporte con tu hosting.
Indica que ya has probado los pasos anteriores.
Pídeles que revisen los logs del servidor (error_log) para identificar la causa exacta.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

¿El error 500 puede deberse a una mala actualización?

Sí, es muy común. Si actualizaste PrestaShop o un módulo y luego apareció el error, prueba a deshabilitar módulos o restaurar una copia de seguridad.

¿Cómo sé si es un problema de PHP o de base de datos?

Si activas el modo debug y ves errores de SQL, es la base de datos. Si son errores de memoria o funciones, es PHP.

¿Puedo evitar el error 500 en el futuro?

Sí: mantén PrestaShop, módulos y temas actualizados, haz copias de seguridad periódicas, y no instales módulos de fuentes no confiables.

¿Qué hago si no puedo acceder ni al Back Office ni al FTP?

Contacta con tu hosting inmediatamente. Ellos pueden acceder a los archivos y logs del servidor.

Conclusión

El error 500 PrestaShop y la pantalla blanca PrestaShop son problemas frustrantes, pero con esta guía paso a paso puedes solucionar error 500 en la mayoría de los casos. Recuerda:

Activa el modo debug para obtener pistas.
Revisa el .htaccess primero (es lo más común).
Ajusta permisos y memoria PHP.
Deshabilita módulos sospechosos.
Si nada funciona, pide ayuda a tu hosting.

Espero que este artículo te haya sido útil. Si tienes dudas, déjalas en los comentarios. ¡Buena suerte con tu tienda!