Error 500 en PrestaShop Plesk | Soluciones efectivas

¿Por qué PrestaShop no carga o muestra un error 500 en Plesk?

Ver un error 500 PrestaShop Plesk en la pantalla es de las cosas más frustrantes que te pueden pasar, sobre todo si tienes una tienda online activa y necesitas que esté funcionando 24/7. La buena noticia es que, en la gran mayoría de los casos, este problema tiene una solución que puedes aplicar tú mismo sin necesidad de ser un experto en servidores.

En esta guía extensa, vamos a desgranar todas las causas posibles y, lo más importante, te daré soluciones paso a paso. Vamos a ir desde lo más básico y sencillo hasta lo más técnico. Respira hondo, coge un café y vamos a por ello. El objetivo es que tu tienda vuelva a estar operativa cuanto antes.

¿Qué significa exactamente un error 500?

Antes de lanzarnos a solucionar nada, es fundamental entender qué está pasando. Un error 500 es un mensaje genérico que devuelve el servidor cuando algo ha fallado internamente, pero no te dice exactamente el qué. Es como si entrases en una oficina y te dijeran "lo sentimos, hay un problema", pero sin darte más detalles.

En el contexto de PrestaShop no carga, este error puede manifestarse de varias formas:

Pantalla en blanco: La página se queda completamente blanca y no carga nada.
Mensaje de error 500: El navegador muestra el típico "Error interno del servidor".
Error 500 en el panel de administración: No puedes acceder ni siquiera al back-office de tu tienda.
Bucle de redirección: La página se queda cargando y nunca termina.

La buena noticia es que, en la mayoría de los casos, el error 500 en PrestaShop se debe a problemas de permisos de archivos, caché corrupta, o archivos .htaccess mal configurados. Vamos a ver cómo solucionarlo.

Primeros pasos: Diagnóstico rápido y seguro

Cuando te enfrentas a un error 500 PrestaShop Plesk, lo primero es no entrar en pánico. Hay una serie de comprobaciones rápidas que puedes hacer para descartar los problemas más comunes.

🔍 Activar el modo debug de PrestaShop

La forma más rápida de saber qué está fallando es activar el modo de depuración (debug). Esto hará que PrestaShop muestre el error real en lugar de la pantalla genérica de 500. Para ello, tendrás que acceder a los archivos de tu tienda a través del administrador de archivos de Plesk o por FTP.

Accede a tu panel de Plesk y ve a "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.
Haz clic derecho sobre él y selecciona "Editar".
Busca la línea que dice define('_PS_MODE_DEV_', false); y cambia false por true.
Guarda los cambios.

[INFO] Una vez hecho esto, recarga tu tienda. Ahora, en lugar del error 500, deberías ver un mensaje de error en PHP con detalles específicos, como "Fatal error: Uncaught Error: Call to undefined function..." o "Permission denied". Este mensaje es oro puro, ya que te indicará exactamente dónde está el problema. Anota ese mensaje y sigue los pasos de este artículo según lo que veas.

🛠️ Comprobar los permisos de archivos y carpetas

En un servidor Linux (que es lo que usa Plesk), cada archivo y carpeta tiene permisos. Si estos permisos son incorrectos, PrestaShop no podrá leer o escribir archivos, lo que provoca el temido error 500.

La configuración estándar y segura para PrestaShop es la siguiente:

Carpetas: Permisos 755.
Archivos: Permisos 644.

Para cambiarlos desde Plesk:

Ve al "Administrador de archivos".
Selecciona todos los archivos y carpetas de la raíz de tu tienda.
Haz clic en "Permisos" o "Cambiar permisos".
Introduce 755 para las carpetas y 644 para los archivos.
Aplica los cambios.

[WARNING] No uses permisos 777 (permisos totales) para todo, aunque sea tentador para "arreglar" el problema rápidamente. Esto es un riesgo de seguridad enorme y cualquier persona podría modificar tus archivos. Úsalo solo de forma temporal y para casos muy específicos.

Soluciones específicas para el error 500 en PrestaShop

Si el diagnóstico rápido no ha solucionado el problema, vamos a profundizar en las causas más comunes y sus soluciones.

🗑️ Limpiar la caché de PrestaShop

PrestaShop guarda archivos de caché para cargar las páginas más rápido. A veces, estos archivos se corrompen o se quedan obsoletos, provocando conflictos y errores. La solución es simple: borrar la caché.

Puedes hacerlo de dos maneras:

Opción A: Desde el panel de administración (si puedes acceder).

Ve a "Parámetros avanzados" > "Rendimiento".
Haz clic en el botón "Vaciar la caché" en la parte superior.

Opción B: Manualmente (si no puedes acceder al panel).

Ve al administrador de archivos de Plesk.
Navega a la carpeta var/cache dentro de tu instalación de PrestaShop. La ruta completa suele ser /httpdocs/var/cache.
Selecciona todas las carpetas y archivos que encuentres dentro (normalmente llamados dev, prod o class_index.php).
Bórralos. No te preocupes, PrestaShop los volverá a generar automáticamente.

📝 Regenerar el archivo .htaccess

El archivo .htaccess es un archivo de configuración crucial para el funcionamiento de PrestaShop. Si está dañado o mal configurado, puede provocar PrestaShop no carga o un error 500.

Cómo regenerarlo:

Accede al administrador de archivos de Plesk.
En la raíz de tu tienda, busca el archivo .htaccess. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Renómbralo a .htaccess_old (por si acaso) o bórralo directamente.
Ahora, intenta acceder a tu tienda. PrestaShop debería generar un nuevo .htaccess automáticamente.
Si el error persiste, entra en tu panel de administración (si es posible) y ve a "Parámetros avanzados" > "Rendimiento". En la sección "Archivo .htaccess", haz clic en "Guardar" para forzar su regeneración.

[TIP] Si tu tienda usa URLs amigables (SEO), después de regenerar el .htaccess, es posible que tengas que ir a "Parámetros avanzados" > "Rendimiento" y guardar de nuevo para que las reglas de reescritura se actualicen.

🔄 Revisar la versión de PHP

PrestaShop es una plataforma que necesita una versión de PHP específica para funcionar correctamente. Si tu versión de PHP es demasiado antigua o demasiado nueva, es muy probable que encuentres errores.

Cómo cambiar la versión de PHP en Plesk:

En tu panel de Plesk, busca la sección de tu dominio y haz clic en "Configuración de PHP".
En el menú desplegable "Versión de PHP", selecciona una versión compatible con tu PrestaShop. Generalmente, las versiones 7.4, 8.0 y 8.1 son buenas opciones.
Guarda los cambios y prueba a cargar tu tienda.

[INFO] Si no estás seguro de qué versión de PHP necesitas, consulta la documentación oficial de PrestaShop. Normalmente, las versiones más recientes de PrestaShop requieren PHP 7.4 o superior. Si tu tienda es antigua, es posible que necesites una versión más baja.

🧩 Desactivar módulos conflictivos

A veces, un módulo recién instalado o actualizado es el culpable del error. Si el problema apareció después de instalar algo nuevo, este es el primer lugar donde debes mirar.

Cómo desactivar módulos sin acceso al panel:

Ve al administrador de archivos de Plesk.
Navega a la carpeta modules en la raíz de tu instalación.
Busca la carpeta del módulo que sospechas que está causando el problema.
Renombra la carpeta, por ejemplo, de mimodulo a mimodulo_off. Esto lo desactivará temporalmente.
Prueba a cargar tu tienda. Si el error desaparece, has encontrado al culpable.

[WARNING] Este método es un poco "a ciegas". Si no sabes qué módulo es, puedes ir renombrando de uno en uno, pero es un proceso lento. Es mejor usarlo como último recurso si no tienes acceso al panel de administración.

Causas más avanzadas y soluciones definitivas

Si has llegado hasta aquí y el problema persiste, es hora de mirar en el servidor y en la configuración más profunda.

🚫 Límite de memoria de PHP (Memory Limit)

PrestaShop puede quedarse sin memoria si el límite de PHP es demasiado bajo. Esto es especialmente común en tiendas con muchos productos o módulos.

Cómo aumentar el límite de memoria:

En Plesk, ve a la "Configuración de PHP" de tu dominio.
Busca la opción memory_limit.
Auméntalo. Un valor de 256M o 512M es recomendable para la mayoría de las tiendas.
Guarda los cambios.

📄 Revisar los logs de errores del servidor

Esta es la forma más fiable de encontrar el error. Los logs contienen un registro detallado de todo lo que sucede en tu servidor.

Cómo acceder a los logs en Plesk:

En Plesk, ve a tu dominio y haz clic en "Registros" o "Logs".
Busca el archivo de log de errores (normalmente llamado error_log o similar).
Descarga o abre el archivo y busca los errores más recientes. Verás líneas con la fecha y la hora del error, y el mensaje de error detallado.

[TIP] Busca en el log errores que contengan "PHP Fatal error" o "PHP Warning". Esos son los que te darán la pista definitiva sobre qué está fallando.

🗄️ Problemas con la base de datos

Aunque es menos común que el error 500, una base de datos corrupta o con la configuración incorrecta también puede causar problemas.

Cómo verificar la base de datos:

En Plesk, ve a "Bases de datos" y localiza la base de datos de tu PrestaShop.
Haz clic en "phpMyAdmin" para acceder a ella.
En la pestaña "Exportar", puedes hacer una copia de seguridad.
En la pestaña "SQL", puedes ejecutar consultas para verificar la integridad. Por ejemplo, puedes ejecutar CHECK TABLE ps_shop_url; (reemplaza ps_ con el prefijo de tu tienda).

[WARNING] No modifiques nada en la base de datos a menos que sepas exactamente lo que estás haciendo. Un error aquí puede ser catastrófico para tu tienda.

¿Y si nada de esto funciona? (Otras herramientas de gestión)

Si has agotado todas las opciones y el error 500 PrestaShop Plesk sigue ahí, puede que el problema sea más profundo o que esté relacionado con la configuración del servidor.

En ese caso, tienes dos opciones:

Contactar con el soporte de tu hosting: Si tu plan de hosting incluye soporte técnico, este es el momento de usarlo. Ellos tienen acceso al servidor y pueden diagnosticar problemas que tú no puedes ver.
Considerar otras herramientas de gestión: Aunque estés usando Plesk, es posible que tu proveedor de hosting ofrezca alternativas. Por ejemplo, si tu hosting usa un panel como Syspanel, recuerda que el acceso se realiza a través del puerto 2106. La interfaz será diferente, pero los conceptos de permisos, PHP y logs son los mismos. A veces, migrar a un panel con mejor soporte o más estabilidad puede ser la solución a largo plazo.

[INFO] Recuerda, si migras a Syspanel, el puerto de acceso es el 2106. La lógica de solución de problemas será idéntica a la que hemos visto aquí: permisos, caché, versión de PHP, etc.

Preguntas Frecuentes (FAQ)

Para terminar, vamos a resolver algunas de las dudas más comunes que suelen tener los usuarios.

❓ ¿Por qué mi PrestaShop da error 500 después de una actualización?

Es muy común. Las actualizaciones pueden cambiar archivos, la estructura de la base de datos o requerir una versión de PHP más reciente. La solución suele ser limpiar la caché, regenerar el .htaccess y verificar que la versión de PHP cumple con los requisitos de la nueva versión de PrestaShop.

❓ ¿El error 500 puede deberse a un problema de mi conexión a internet?

No. El error 500 es un error del servidor. Si fuera un problema de tu conexión, verías un mensaje de "No se puede acceder al sitio" o un error de tiempo de espera, no un código 500.

❓ ¿Puedo prevenir el error 500 en el futuro?

Sí, en gran medida. Mantén tu PrestaShop, sus módulos y su tema actualizados. Realiza copias de seguridad periódicas. No instales módulos de fuentes no confiables. Y, sobre todo, asegúrate de que los permisos de tus archivos sean los correctos.

❓ ¿Qué hago si el error 500 aparece solo en el panel de administración?

El problema suele estar relacionado con un módulo o con la caché. Intenta limpiar la caché manualmente (borrando la carpeta var/cache) y desactivar los módulos uno por uno para encontrar al culpable.

❓ ¿Cuánto tiempo se tarda en solucionar un error 500?

Depende de la causa. Los problemas más comunes (caché, permisos, .htaccess) se solucionan en minutos. Los problemas más complejos (base de datos, módulos conflictivos) pueden llevar más tiempo de diagnóstico.

Conclusión final

Un error 500 PrestaShop Plesk es una molestia, pero no es el fin del mundo. Con un enfoque metódico y las soluciones que te he dado, podrás diagnosticar y resolver el problema en la mayoría de los casos. Recuerda siempre empezar por lo más simple (caché y permisos) y luego ir avanzando hacia soluciones más complejas (logs y base de datos).

Espero que esta guía te haya sido de gran ayuda. No te desesperes, respira, sigue los pasos y verás como tu tienda vuelve a estar operativa. ¡Mucha suerte!