Error 500 en PrestaShop con Plesk: Causas y soluciones

¡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 alojada en un servidor con Plesk. No te preocupes, es uno de los errores más comunes en el mundo del hosting y, en la mayoría de los casos, tiene solución sin necesidad de ser un experto en programación.

En esta guía completa, paso a paso y en un lenguaje muy sencillo, vamos a desglosar cómo solucionar el error 500 en PrestaShop cuando tu panel de control es Plesk. Vamos a mirar desde los archivos más sospechosos (como el .htaccess) hasta cómo leer los logs de Plesk para encontrar al culpable exacto.

Respira hondo, coge un café y vamos a ello. Al final de este artículo, tendrás un plan de acción claro para volver a poner tu tienda online en marcha.

¿Qué significa exactamente un Error 500 en PrestaShop?

Antes de lanzarnos a tocar cosas, es importante entender qué está pasando. Un error 500 es un mensaje genérico que envía el servidor cuando algo ha salido mal internamente, pero no puede especificar el motivo exacto en la propia página (por razones de seguridad).

Imagina que el servidor es un restaurante. El error 500 es como si el chef dijera: "No puedo preparar tu plato, pero no voy a salir a explicarte si es porque no hay tomates, porque se ha quemado la cocina o porque el horno está roto". Simplemente, te dice que no puede servirte.

En el contexto de PrestaShop y Plesk, las causas más habituales suelen ser:

Un archivo .htaccess corrupto o con directivas incompatibles.
Permisos de archivos y carpetas incorrectos.
Un módulo o override (personalización) que está dando problemas.
Falta de memoria PHP (límite de memoria agotado).
Errores en la configuración de la versión de PHP.
Un archivo .htaccess que ha sido modificado por una actualización o un módulo.

Vamos a atacar estos puntos uno por uno, de la solución más fácil a la más compleja.

Primeros Pasos: La Inspección Rápida en Plesk

Cuando veas el Plesk error 500, no entres en pánico. Antes de tocar archivos, vamos a hacer una pequeña comprobación visual en tu panel de control.

1. Comprueba la Versión de PHP y la Configuración

A veces, el error viene porque tu tienda necesita una versión de PHP específica y el servidor está usando otra. Esto es muy común después de migraciones o actualizaciones de PrestaShop.

Inicia sesión en tu panel de Plesk.
Busca la sección de "Hosting y DNS" o "Sitios web y dominios".
Haz clic en tu dominio (el de la tienda).
Busca la opción "Configuración de PHP" (a veces aparece como un icono con las letras "PHP").
Aquí verás un menú desplegable para elegir la versión de PHP. PrestaShop 1.7 y 8.x necesitan al menos PHP 7.1, pero recomendamos PHP 7.4 u 8.0 para un mejor rendimiento.

[TIP]: Si no sabes qué versión usar, prueba con una versión superior a la que tienes actualmente. A veces, el simple hecho de cambiar de PHP 7.1 a 7.4 o 8.0 soluciona el error al instante.

2. Activa el Modo Depuración de PrestaShop (Debug Mode)

Esta es la forma más rápida de obtener información. PrestaShop puede mostrarte el error real en pantalla si activamos su modo de depuración.

No te preocupes, es un proceso sencillo. Vamos a hacerlo a través del archivo de configuración.

Ve a "Administrador de archivos" en Plesk (normalmente dentro de tu dominio).
Navega a la carpeta /httpdocs (o public_html). Esta es la raíz de tu tienda.
Busca el archivo llamado config/defines.inc.php.
Haz clic derecho sobre él y selecciona "Editar en el editor de texto" o algo similar.
Busca la línea que dice: define('_PS_MODE_DEV_', false);
Cambia la palabra false por true. Quedará así: define('_PS_MODE_DEV_', true);
Guarda los cambios.

Ahora, recarga tu tienda. En lugar del error 500, verás un mensaje de error detallado en pantalla, con una ruta de archivo y una línea de código. ¡Eso es oro puro! Anota ese mensaje, porque nos dirá exactamente qué archivo está fallando.

[WARNING]: No dejes el modo depuración activado en una tienda en producción (en vivo). Es un riesgo de seguridad. Cuando termines de solucionar el problema, vuelve a cambiar true a false.

Solucionar el Error 500: El Sospechoso Habitual (`.htaccess`)

Si el modo depuración no te da pistas claras o prefieres ir directo al grano, el archivo .htaccess es el primer lugar donde debemos mirar. Es un archivo de configuración que Apache (el servidor web) lee constantemente. Si tiene una línea mala, todo el sitio se cae.

Regenerando el `.htaccess` desde el Panel de Administración

La forma más elegante de solucionar un .htaccess corrupto es regenerarlo desde el propio PrestaShop.

Accede a tu panel de administración de PrestaShop (normalmente en tudominio.com/admin).
Ve al menú "Parámetros avanzados" -> "Rendimiento".
Busca la sección "Redireccionamiento y caché de Apache" o similar.
Asegúrate de que la opción "Usar la caché de Apache para las hojas de estilos" esté desactivada.
Haz clic en el botón "Guardar". Este simple gesto suele forzar la regeneración del archivo .htaccess.

Si no puedes acceder al panel de administración porque también te da error, tendremos que hacerlo a mano.

Renombrar el `.htaccess` para Aislar el Problema

Esta es una técnica de diagnóstico perfecta para saber si el problema es este archivo.

Ve al "Administrador de archivos" de Plesk.
Navega a la raíz de tu tienda (la carpeta httpdocs).
Busca el archivo llamado .htaccess. Nota: En el administrador de archivos de Plesk, los archivos ocultos (que empiezan por un punto) a veces no se ven. Busca un icono o un botón para "Mostrar archivos ocultos" en la parte superior del administrador.
Una vez lo veas, haz clic derecho sobre él y selecciona "Renombrar".
Cámbiale el nombre a algo como .htaccess.bak (o .htaccess.old).
Ahora, intenta cargar tu tienda.

¿Qué ha pasado?

Si el error 500 desaparece: ¡Enhorabuena! El problema era el .htaccess. Ahora, intenta acceder a tu panel de administración y ve a "Parámetros avanzados" -> "Rendimiento" y guarda la configuración para que PrestaShop genere uno nuevo. Si no puedes, simplemente borra el .htaccess.bak y crea uno nuevo vacío. PrestaShop lo rellenará solo.
Si el error 500 continúa: El problema no es el .htaccess. Podemos descartarlo. Vuelve a renombrarlo a su nombre original (.htaccess) para no dejar el sitio en un estado extraño.

Permisos de Archivos y Carpetas: La Causa Silenciosa

Otra causa muy común del error 500 PrestaShop son los permisos incorrectos. Cada archivo y carpeta tiene una "etiqueta" que le dice al servidor quién puede leer, escribir o ejecutar.

Si los permisos son demasiado restrictivos, el servidor no puede leer los archivos de la tienda y se produce el error.

Cómo Configurar los Permisos Correctos en Plesk

En el "Administrador de archivos" de Plesk, ve a la raíz de tu tienda (httpdocs).
Selecciona TODOS los archivos y carpetas (puedes usar Ctrl+A o el botón de seleccionar todo).
Haz clic en el botón "Permisos" (suele estar en la barra superior o al hacer clic derecho).
Se abrirá una ventana con casillas de verificación. Lo que necesitamos es:
- Carpetas (Directorios): Permisos 755.
- Archivos: Permisos 644.

En la ventana de Plesk, esto se traduce en marcar las casillas de "Lectura y escritura" para el propietario, y solo "Lectura y ejecución" para el grupo y el público. Pero ojo, no es una ciencia exacta con las casillas.

[INFO]: Si no tienes claro cómo hacerlo con las casillas, la forma más fiable es usar un cliente FTP como FileZilla. Conéctate a tu servidor, selecciona todos los archivos de la raíz, haz clic derecho -> "Permisos de archivos" y escribe 644 para archivos y 755 para carpetas. Marca la casilla "Recursivo" para que se aplique a todas las subcarpetas.

Casos Especiales: La Carpeta `var/cache` y `config`

A veces, incluso con los permisos correctos, la carpeta de caché de PrestaShop puede estar corrupta.

Dentro de la raíz de tu tienda, busca la carpeta var/cache (si usas PrestaShop 1.7 o 8.x) o cache (si usas 1.6).
Borra todo el contenido de esa carpeta (los archivos que hay dentro, no la carpeta en sí).
Si no te deja borrarlos, renombra la carpeta cache a cache_old y crea una nueva carpeta vacía llamada cache con permisos 755.

Este "vaciar la caché" a mano es un remedio infalible para muchos dolores de cabeza.

Leyendo los Logs de Plesk: La Evidencia Definitiva

Si nada de lo anterior ha funcionado, es hora de ponerse el sombrero de detective y mirar los logs de Plesk. Aquí es donde el servidor anota absolutamente todos los errores que ocurren.

Dónde Encontrar los Logs de Error

En tu panel de Plesk, ve a "Sitios web y dominios".
Haz clic en tu dominio.
Busca la sección "Logs" (a veces está en la pestaña de "Estadísticas" o como un icono separado).
Verás una lista de archivos de log. El que nos interesa es el que se llama error_log o error.log.

Haz clic en él para ver su contenido. Verás líneas de texto que empiezan con una fecha y una hora.

Interpretando las Líneas del Log

Busca la hora exacta en la que empezó el error. Las líneas de error típicas se ven así:

[Fri Jan 20 10:00:00 2024] [error] [client 192.168.1.1] ModSecurity: Access denied with code 500 (phase 2). Pattern match...

O la más común y útil:

[Fri Jan 20 10:00:00 2024] [error] [client 192.168.1.1] PHP Fatal error:  Uncaught Error: Call to undefined method...

¿Qué significa esto?

Si ves "PHP Fatal error", el problema está en un archivo PHP concreto. La propia línea te dirá el archivo y la línea exacta (ej: ... in /var/www/vhosts/tudominio.com/httpdocs/modules/mimodulo/mimodulo.php on line 45). Ahí tienes al culpable.
Si ves "ModSecurity", es un firewall de aplicaciones web (WAF) que está bloqueando algo. Esto es más complejo, pero a menudo se soluciona desactivando temporalmente ModSecurity para tu dominio en Plesk (dentro de la configuración de tu dominio, busca "ModSecurity" o "Seguridad").

[TIP]: El archivo error_log es tu mejor amigo. Si no lo encuentras en el panel de Plesk, también puedes conectarte por FTP y mirar en la raíz de tu tienda (httpdocs). Ahí suele estar el archivo error_log o logs/error_log.

Otras Soluciones Avanzadas (Pero Sencillas)

Si has llegado hasta aquí y el error persiste, no te rindas. Hay un par de cosas más que puedes probar.

Aumentar el Límite de Memoria PHP

A veces, PrestaShop necesita más memoria de la que el servidor le permite por defecto.

Ve a "Configuración de PHP" en Plesk (como hicimos al principio).
Busca la opción memory_limit.
Si está en 128M o menos, cámbiala a 256M o incluso 512M.
Guarda los cambios y recarga tu tienda.

Desactivar Módulos Recientes (Si Puedes Acceder al Admin)

Si el error empezó justo después de instalar un módulo nuevo, ese es el sospechoso.

Si tienes acceso al panel de administración, ve a "Módulos" -> "Módulos y servicios".
Ordena la lista por fecha de instalación.
Desactiva el módulo más reciente y comprueba si el error desaparece.

Si no tienes acceso al panel, puedes renombrar la carpeta del módulo en el administrador de archivos (dentro de /httpdocs/modules/nombredelmodulo) a nombredelmodulo.bak. Si el error desaparece, ese módulo era el problema.

Resumen y Plan de Acción Final

Vamos a concluir con una lista de verificación para que vayas tachando pasos:

Reinicia el sitio y comprueba si es un error temporal.
Activa el modo depuración de PrestaShop para ver el error exacto.
Regenera o renombra el archivo .htaccess.
Verifica los permisos de archivos (644) y carpetas (755), prestando especial atención a var/cache.
Aumenta el límite de memoria PHP a 256M.
Lee los logs de Plesk (error_log) para encontrar el archivo PHP problemático.
Desactiva módulos recientes o renombra sus carpetas.

[WARNING]: Si después de todo esto el error persiste, es hora de contactar con tu proveedor de hosting. Puede que haya un problema en el servidor que esté fuera de tu alcance, como un fallo en el disco duro o una mala configuración global de Plesk. Dales el contenido del error_log que has encontrado; les será de gran ayuda.

Espero que esta guía te haya sido de utilidad. El error 500 en PrestaShop es un rito de iniciación para cualquier administrador de tiendas online, pero con paciencia y un buen método, se supera. ¡Buena suerte con tu tienda!