Solucionar error 500 en PrestaShop alojado en Plesk

¡Vaya! Ver un error 500 en PrestaShop con Plesk puede ser frustrante, especialmente cuando tu tienda online deja de funcionar de repente. Pero no te preocupes, estoy aquí para ayudarte a entender qué está pasando y, lo más importante, cómo solucionarlo paso a paso.

Este error interno del servidor (Internal Server Error) es un mensaje genérico que indica que algo salió mal, pero no te dice exactamente qué. Es como si el coche no arrancara y el tablero solo mostrara "fallo general". La buena noticia es que, con un poco de paciencia y siguiendo este instructivo, podrás identificar la causa y solucionar el error 500 en PrestaShop de manera efectiva.

¿Por qué aparece el error 500 en PrestaShop con Plesk?

Antes de lanzarnos a las soluciones, es importante entender las causas más comunes. El error 500 en PrestaShop Plesk suele deberse a problemas de configuración, archivos corruptos o limitaciones del servidor. Aquí tienes las razones más frecuentes:

Causas principales del error interno del servidor

Problemas de permisos de archivos o carpetas: PrestaShop necesita permisos específicos para leer y escribir archivos. Si estos cambian (por ejemplo, al subir archivos por FTP o al instalar un módulo), el sistema falla.
Archivo .htaccess corrupto o mal configurado: Este archivo es crucial para las reglas de reescritura de URL y la seguridad. Si se daña o contiene reglas incorrectas, provoca un error 500.
Módulos o temas incompatibles: A veces, al instalar un nuevo módulo o tema, entran en conflicto con la versión de PrestaShop o con otros componentes.
Límites de memoria PHP excedidos: Si tu tienda tiene muchas visitas, catálogos grandes o módulos pesados, puede superar el límite de memoria permitido.
Errores en el código PHP: Archivos de núcleo corruptos, modificaciones incorrectas o actualizaciones fallidas pueden generar errores internos.
Problemas con la base de datos: Una tabla corrupta o una consulta mal formada pueden causar un error 500.

Soluciones paso a paso para solucionar el error 500 en PrestaShop

Vamos a seguir un orden lógico, desde lo más simple y menos invasivo hasta lo más complejo. No te saltes pasos; empieza por el primero y avanza si no funciona.

1. Activa el modo debug de PrestaShop (la clave para entender el error)

Por defecto, PrestaShop oculta los detalles del error 500. Activando el modo debug podrás ver el mensaje de error real, lo que te dará pistas precisas.

Pasos para activar el modo debug:

Accede a tu panel de control Plesk.
Ve a Archivos o Administrador de archivos.
Navega hasta la raíz de tu instalación de PrestaShop (normalmente httpdocs o public_html).
Busca el archivo config/defines.inc.php y ábrelo con el editor de texto.
Localiza esta línea:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
Guarda los cambios y recarga tu tienda. Ahora verás un mensaje de error detallado (por ejemplo, "Fatal error: Allowed memory size of..."). ¡Esa es tu pista!

[WARNING] No dejes el modo debug activado en una tienda en producción, ya que expone información sensible. Una vez resuelto el error, vuelve a poner false.

2. Revisa los permisos de archivos y carpetas

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

Pasos para corregir permisos:

Desde Plesk, ve a Archivos.
Selecciona toda la carpeta raíz de PrestaShop.
Haz clic en Cambiar permisos.
Configura lo siguiente (es el estándar para PrestaShop):
- Carpetas (directorios): 755 (rwxr-xr-x)
- Archivos: 644 (rw-r--r--)
- Archivos de configuración (config/settings.inc.php): 444 o 644 (nunca 777)
Aplica los cambios de forma recursiva (a todas las subcarpetas y archivos).

[TIP] Si usas FTP, puedes hacerlo desde tu cliente FTP seleccionando todos los archivos y cambiando permisos en masa.

3. Limpia la caché de PrestaShop y la de Plesk

A veces, una caché corrupta puede generar errores. Limpiarla es rápido y sencillo.

Pasos para limpiar la caché de PrestaShop:

Accede a tu panel de administración de PrestaShop (si puedes, a veces el error impide el acceso).
Ve a Parámetros avanzados > Rendimiento.
Haz clic en Limpiar caché (tanto de Smarty como de almacenamiento en caché).

Si no puedes acceder al panel, hazlo manualmente:

Conéctate por FTP o al Administrador de archivos de Plesk.
Elimina el contenido de la carpeta var/cache/ (en PrestaShop 1.7) o cache/ (en PrestaShop 1.6). No elimines la carpeta, solo su contenido.
También puedes eliminar el archivo cache/class_index.php si existe.

Limpia la caché de Plesk:

En Plesk, ve a Herramientas y configuraciones.
Busca Limpiar caché o Caché de archivos y ejecútalo.

4. Renombra o elimina el archivo .htaccess

Un archivo .htaccess corrupto puede estar causando el error. Renombrarlo desactivará las reglas de reescritura de URL.

Pasos para gestionar el .htaccess:

En el Administrador de archivos de Plesk, localiza el archivo .htaccess en la raíz de tu tienda.
Renómbralo a htaccess_backup.txt o algo similar.
Recarga tu tienda. Si el error desaparece, el problema está en el .htaccess.
Para regenerarlo correctamente, ve al panel de administración de PrestaShop > Parámetros avanzados > SEO y URLS y haz clic en Guardar (sin cambiar nada). Esto recreará el archivo.

Si no puedes acceder al panel, copia un .htaccess de una instalación limpia de PrestaShop o usa el siguiente contenido básico (ajusta la ruta si es necesario):

# ~~start~~ No se ha modificado nada, solo es un ejemplo
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# ~~end~~

5. Aumenta los límites de memoria PHP

Los límites de memoria baja son una causa frecuente, sobre todo en tiendas con muchos productos o módulos.

Pasos para aumentar la memoria PHP desde Plesk:

En Plesk, ve a Configuración de PHP (suele estar en Herramientas y configuraciones o en el dominio específico).
Busca la opción memory_limit.
Auméntalo a 256M o 512M. También puedes subir max_execution_time a 120 y upload_max_filesize a 64M.
Guarda los cambios.

[INFO] Si no encuentras la opción, puedes crear un archivo php.ini en la raíz de PrestaShop con este contenido:

memory_limit = 512M
max_execution_time = 120
upload_max_filesize = 64M

6. Desactiva módulos y temas problemáticos

Si el error apareció después de instalar un módulo o tema, es probable que sea el culpable.

Pasos para desactivar módulos desde el panel (si puedes acceder):

Ve a Módulos > Gestor de módulos.
Desactiva el módulo sospechoso (el último que instalaste).

Si no puedes acceder al panel, hazlo desde la base de datos (con cuidado):

En Plesk, ve a Bases de datos y selecciona la de tu PrestaShop.
Abre phpMyAdmin.
Busca la tabla ps_modules (el prefijo puede variar).
Localiza el módulo problemático y cambia su estado de 1 (activo) a 0 (inactivo).

Para cambiar de tema temporalmente:

En la misma base de datos, busca la tabla ps_configuration.
Busca la clave PS_THEME_NAME y cámbiala a un tema predeterminado como classic (PrestaShop 1.7) o default-bootstrap (PrestaShop 1.6).

7. Verifica la base de datos

Una tabla corrupta puede generar errores internos.

Pasos para reparar la base de datos:

En Plesk, ve a Bases de datos y selecciona tu base de datos.
Abre phpMyAdmin.
Selecciona todas las tablas (marca la casilla superior).
En el menú desplegable "Con seleccionadas", elige Reparar tabla. Esto intentará arreglar cualquier corrupción.

[WARNING] Siempre haz una copia de seguridad de tu base de datos antes de hacer cambios manuales.

8. Revisa los logs del servidor en Plesk

Si nada de lo anterior funciona, los logs del servidor te darán la respuesta definitiva.

Pasos para acceder a los logs:

En Plesk, ve a Sitios web y dominios > selecciona tu dominio.
Busca Registros o Logs.
Revisa el error_log (normalmente llamado error.log). Busca líneas con la fecha y hora del error 500. Allí verás el mensaje exacto de PHP (por ejemplo, "require(): Failed opening required...").

9. Reinstala o repara los archivos del núcleo de PrestaShop

Como último recurso, si el error persiste, puede que los archivos del núcleo estén dañados.

Pasos para reparar el núcleo:

Descarga la misma versión de PrestaShop que tienes instalada desde prestashop.com.
Extrae el archivo ZIP en tu ordenador.
Sube solo la carpeta admin y la carpeta themes (si tienes un tema personalizado, no la subas) y la carpeta modules (con cuidado de no sobrescribir módulos de terceros que hayas configurado).
Sobrescribe los archivos en tu servidor mediante FTP o el Administrador de archivos de Plesk.

[INFO] Si tienes acceso a Syspanel (el panel que mencionas, cuyo puerto de acceso es el 2106), también puedes realizar desde allí una restauración de archivos desde una copia de seguridad reciente, si la tienes.

Preguntas frecuentes (FAQ) sobre el error 500 en PrestaShop

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

Sí, absolutamente. Si tu proveedor de hosting actualizó la versión de PHP (por ejemplo, de 7.4 a 8.0 o 8.1), algunos módulos o el propio PrestaShop pueden no ser compatibles. Solución: Vuelve a la versión anterior de PHP desde la configuración de Plesk o actualiza PrestaShop y todos sus módulos.

¿Cómo sé si el error es por un módulo o por el tema?

La mejor forma es desactivar todos los módulos no esenciales (como vimos en el paso 6) y cambiar al tema predeterminado. Si el error desaparece, el problema está en lo que desactivaste.

¿Puede un plugin de caché de terceros causar un error 500?

Sí, especialmente si la caché se corrompe. Limpiar la caché del módulo (desde su configuración) o desactivarlo temporalmente suele resolverlo.

¿Qué hago si no puedo acceder ni al panel de administración de PrestaShop?

Sigue todos los pasos manuales descritos en esta guía: activar modo debug desde FTP, corregir permisos, renombrar .htaccess, aumentar memoria PHP desde Plesk y revisar logs. Si aún así no funciona, contacta con tu soporte técnico de hosting.

¿El error 500 puede ser por un ataque o malware?

Es posible. Si tu tienda ha sido hackeada, pueden haber inyectado código malicioso que genere errores. Ejecuta un escaneo de seguridad desde Plesk (si tu plan lo incluye) o revisa los archivos en busca de código sospechoso (por ejemplo, en index.php o archivos de configuración).

Conclusión: No te desesperes, el error 500 tiene solución

Un error 500 en PrestaShop con Plesk puede parecer un muro infranqueable, pero como has visto, siguiendo estos pasos de forma ordenada podrás identificar y solucionar el error 500 en la mayoría de los casos. Recuerda siempre:

Empieza por lo más simple: Activar el modo debug te ahorrará horas de adivinanzas.
No modifiques archivos sin hacer una copia de seguridad (tanto de archivos como de base de datos).
Los logs del servidor son tu mejor amigo: Aprende a leerlos, te darán la respuesta exacta.

Si después de todo el error persiste, no dudes en contactar con el soporte técnico de tu hosting. Proporciónales los mensajes de error exactos (los que viste en el modo debug o en los logs) y ellos podrán ayudarte de forma más rápida.

¡Espero que esta guía te haya sido de gran ayuda! Ahora ya tienes las herramientas para enfrentarte a cualquier error interno del servidor en tu tienda PrestaShop.