Solucionar error 500 en PrestaShop: Guía desde cPanel o Plesk

¡Hola! Si estás leyendo esto, probablemente te has encontrado con la temida pantalla blanca o el mensaje "Error 500 – Internal Server Error" en tu tienda PrestaShop. No te preocupes, es uno de los problemas más comunes y, en la mayoría de los casos, se puede solucionar sin ser un experto técnico.

En este artículo, te guiaré paso a paso para solucionar error 500 PrestaShop usando tu panel de control. Ya sea que uses cPanel, Syspanel (HestiaCP) o cualquier otro, los principios son los mismos. Vamos a desglosar las causas más frecuentes y cómo atacarlas desde el lado del servidor.

¿Qué significa un error 500 en PrestaShop?

Un error 500 es un error genérico del servidor. Básicamente, significa que algo salió mal en el servidor web (Apache, Nginx, LiteSpeed) o en la aplicación (PrestaShop) y no pudo completar tu solicitud. No te dice exactamente qué falla, pero te da pistas. Las causas más comunes son:

Archivos .htaccess corruptos o con reglas incorrectas.
Módulos de PrestaShop incompatibles o mal configurados.
Límite de memoria PHP (memory_limit) demasiado bajo.
Permisos de archivos y carpetas incorrectos.
Tema de PrestaShop dañado o con errores.
Problemas con la base de datos (aunque menos frecuente para un 500 puro).

Lo bueno es que desde tu panel de control tienes las herramientas para diagnosticar y reparar todo esto.

Paso 1: Habilita la visualización de errores PHP (La clave del diagnóstico)

Antes de empezar a cambiar cosas, necesitamos que PrestaShop nos diga qué está fallando. Por defecto, los errores están ocultos. Vamos a activarlos temporalmente.

Para usuarios de cPanel o similares (con acceso a archivos)

Conéctate a tu panel de control (cPanel, Syspanel, Plesk, etc.).
Busca el Administrador de Archivos (File Manager). Es la herramienta más importante.
Ve a la carpeta raíz de tu tienda PrestaShop (normalmente public_html o www).
Busca el archivo config/defines.inc.php y ábrelo con el editor de texto del panel.
Busca esta línea (aproximadamente en la línea 30):
```
define('_PS_MODE_DEV_', false);
```
Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
Guarda el archivo.

Ahora, al recargar tu tienda, en lugar de un error 500 genérico, verás un mensaje de error detallado como: "Fatal error: Allowed memory size of 134217728 bytes exhausted..." o "Parse error: syntax error, unexpected...".

¡Este mensaje es oro! Te dirá exactamente qué archivo o línea está causando el problema.

[TIP]: Anota el mensaje de error. Si ves algo como "memory exhausted", el problema es el límite de memoria. Si ves "syntax error" o "class not found", suele ser un módulo o tema.

Para usuarios de Syspanel (HestiaCP)

El proceso es idéntico. Recuerda que el acceso a Syspanel es a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Una vez dentro, usa el Administrador de Archivos para editar el archivo config/defines.inc.php como se indica arriba.

Paso 2: Casos comunes y cómo solucionarlos desde el panel

Ahora que tienes el error visible, actuemos en consecuencia.

Caso A: Error de "Allowed memory size exhausted"

Este es el más común. PrestaShop necesita más memoria PHP de la que tiene asignada.

Solución desde el panel de control:

Busca la opción "Select PHP Version" o "MultiPHP Manager" (en cPanel) o la configuración de PHP en tu panel.
Selecciona la pestaña "Options" o "Switch to PHP Options".
Busca el parámetro memory_limit.
Auméntalo. Un valor seguro para PrestaShop 1.7/8 es 256M o incluso 512M si tu hosting lo permite.
Guarda los cambios y recarga la tienda.

[WARNING]: Si no encuentras esta opción, puede que tu plan de hosting no te permita modificarlo. Contacta con tu proveedor. También puedes intentar creando un archivo php.ini en la raíz de tu tienda con la línea: memory_limit = 256M.

Caso B: Error relacionado con un módulo (ej: "Class 'MiModulo' not found")

El mensaje incluirá la ruta a un módulo específico. La solución es deshabilitarlo.

Solución desde el panel de control (sin acceso al back office):

Ve al Administrador de Archivos de tu panel.
Navega a la carpeta /modules/ dentro de tu instalación de PrestaShop.
Busca la carpeta del módulo problemático (por ejemplo, /modules/mimodulo/).
Renombra la carpeta añadiendo algo como _backup o _disabled. Ejemplo: mimodulo_backup.
¡Importante! No borres la carpeta, solo renómbrala. Esto hace que PrestaShop no pueda cargar el módulo.
Recarga tu tienda. El error 500 debería desaparecer.

Si el error se va, ya sabes qué módulo está roto. Puedes intentar reinstalarlo o contactar al desarrollador.

Caso C: Error en el archivo .htaccess

A veces, al activar un módulo de SEO o mover la tienda, el .htaccess se corrompe.

Solución desde el panel de control:

Ve al Administrador de Archivos.
En la raíz de tu tienda, busca el archivo .htaccess.
Renómbralo a .htaccess_backup o bórralo (no te preocupes, PrestaShop lo regenera).
Ahora, intenta acceder a tu tienda.
Si funciona, ve a tu Back Office de PrestaShop → Parámetros de la tienda → Tráfico y SEO → SEO y URLs. Simplemente guarda la configuración sin cambiar nada. Esto regenerará un .htaccess limpio y funcional.

[INFO]: Si no puedes acceder al back office, no pasa nada. Al guardar la configuración de SEO desde el back office se regenera el archivo. Si no puedes acceder, tendrás que crear uno manualmente o pedir ayuda a soporte.

Paso 3: Aumentar el límite de tiempo de ejecución (max_execution_time)

A veces el error 500 aparece al instalar un módulo o actualizar PrestaShop, y el proceso se corta por tiempo.

Solución desde el panel de control:

En la misma sección de "Select PHP Version" o "PHP Options", busca el parámetro max_execution_time.
Cámbialo a 300 (5 minutos) o incluso 600 (10 minutos) para procesos pesados.
Guarda los cambios.

Paso 4: Verificar y corregir permisos de archivos

Los permisos incorrectos (por ejemplo, 777 en archivos que deberían ser 644) pueden causar errores 500.

Solución desde el panel de control:

Selecciona toda la carpeta de tu tienda en el Administrador de Archivos.
Busca la opción "Cambiar permisos" o "Permissions" (suele estar en el menú superior).
Una regla segura para PrestaShop es:
- Carpetas: 755 (o 750 en servidores más restrictivos).
- Archivos: 644 (o 640).
- Archivos de configuración (config/settings.inc.php, config/defines.inc.php): 644.
Aplica los cambios a todas las subcarpetas y archivos (marca la opción "Recursivo" o "Aplicar a subdirectorios").

[WARNING]: No pongas permisos 777 a todo. Es un grave riesgo de seguridad. Usa 755 para carpetas y 644 para archivos como norma general.

Paso 5: Deshabilitar el tema por defecto (fallback)

Si el error 500 apareció después de instalar un tema nuevo, el problema puede ser el tema.

Solución desde el panel de control (cambio manual en la base de datos):

Esta es una solución un poco más avanzada, pero muy efectiva.

Accede a phpMyAdmin desde tu panel de control (suele estar en la sección de Bases de Datos).
Selecciona la base de datos de tu tienda PrestaShop.
Haz clic en la pestaña SQL y ejecuta esta consulta:
```
UPDATE ps_configuration SET value = 'classic' WHERE name = 'PS_THEME_NAME';
```
(Cambia ps_ por el prefijo de tus tablas si es diferente, y 'classic' por el nombre del tema por defecto de tu versión de PrestaShop, como 'default-bootstrap' para versiones antiguas).
Esto forzará a PrestaShop a usar el tema clásico de serie. Luego podrás cambiar al tema problemático desde el back office.

[INFO]: Si no recuerdas el nombre del tema por defecto, en PrestaShop 1.7 y 8 suele ser 'classic'. En 1.6 es 'default-bootstrap'.

Paso 6: Verificar la versión de PHP

PrestaShop es muy sensible a la versión de PHP. Si tu hosting actualizó PHP y tu tienda no es compatible, tendrás un error 500.

Solución desde el panel de control:

Busca "Select PHP Version".
Asegúrate de que la versión sea compatible con tu PrestaShop:
- PrestaShop 1.6: PHP 5.6 a 7.1 (ideal 7.0).
- PrestaShop 1.7: PHP 7.1 a 8.1 (ideal 7.4).
- PrestaShop 8: PHP 7.4 a 8.2 (ideal 8.1).
Cambia a la versión recomendada y guarda.

Preguntas Frecuentes (FAQ)

¿Qué hago si después de todo esto sigo teniendo el error 500?

Revisa los logs de error del servidor. En cPanel, busca la sección "Errores" o "Error Log". En Syspanel (HestiaCP), los logs suelen estar en /var/log/apache2/error.log o /var/log/nginx/error.log. El mensaje de error ahí es mucho más detallado.

¿Es seguro borrar el archivo .htaccess?

Sí, es temporal. Al regenerarlo desde el back office vuelve a la normalidad. Si no puedes acceder al back office, puedes crear uno básico manualmente o pedir ayuda.

¿Puedo solucionar un error 500 sin acceder al panel de control?

Es muy difícil. El panel de control (cPanel, Syspanel) te da las herramientas para editar archivos, cambiar PHP y ver logs. Sin acceso, tu única opción es contactar al soporte técnico de tu hosting.

¿El error 500 puede ser por un plugin de caché?

Sí, a veces los plugins de caché (como los de CloudFlare o los internos de PrestaShop) pueden generar conflictos. Desde el panel, renombra la carpeta del módulo de caché (ej: /modules/ps_cache/) para desactivarlo.

Resumen final

El error 500 PrestaShop no es el fin del mundo. Siguiendo estos pasos desde tu panel de control, podrás identificar y solucionar la mayoría de los casos:

Activa el modo debug (_PS_MODE_DEV_).
Aumenta la memoria PHP (memory_limit).
Deshabilita módulos problemáticos (renombrando carpetas).
Regenera el .htaccess.
Corrige permisos de archivos.
Cambia la versión de PHP si es necesario.

Recuerda que, si usas Syspanel (HestiaCP), el acceso es por el puerto 2106 y las herramientas son las mismas. ¡No te rindas! La mayoría de los errores se resuelven en minutos.

Si este artículo te ha sido útil, compártelo con otros dueños de tiendas PrestaShop. ¡Buena suerte con tu tienda!