Solución de errores comunes en PrestaShop alojado en Plesk

¿Tu tienda PrestaShop se ha quedado en blanco, da un error 500 o simplemente no carga? Tranquilo, es más común de lo que crees. Si tienes tu tienda alojada en un servidor Plesk, estos problemas suelen tener soluciones muy concretas y sencillas de aplicar. En esta guía te voy a explicar paso a paso cómo solucionar los errores PrestaShop Plesk más frecuentes, desde la temida página en blanco hasta problemas de conexión con la base de datos. No necesitas ser un experto técnico; solo sigue las instrucciones al pie de la letra y tendrás tu tienda funcionando en minutos.

¿Por qué aparecen estos errores en PrestaShop con Plesk?

PrestaShop es un software exigente que necesita una configuración específica del servidor para funcionar correctamente. Plesk es un panel de control muy potente, pero a veces sus valores por defecto (como los límites de memoria o la versión de PHP) no son los ideales para PrestaShop. Además, errores como subir un módulo incompatible, modificar un archivo por error o una actualización fallida pueden desencadenar estos problemas.

[INFO] La mayoría de los errores críticos de PrestaShop se deben a tres causas: falta de memoria PHP, módulos incompatibles o permisos de archivos incorrectos. En Plesk, solucionar estos puntos es muy rápido.

Solucionar el error "Página en blanco" (White Screen of Death)

Este es, sin duda, el error más temido. Abres tu tienda y solo ves una pantalla blanca, sin texto ni mensaje. Es frustrante, pero solucionar problemas PrestaShop como este es más fácil de lo que parece.

Paso 1: Activar el modo debug de PrestaShop

Lo primero es saber qué está fallando exactamente. Para ello, necesitas activar el modo de depuración (debug) de PrestaShop.

1. Conéctate a tu servidor mediante FTP (FileZilla, por ejemplo) o al administrador de archivos de Plesk.
2. Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
3. Descarga una copia de seguridad de este archivo (por si acaso).
4. Edita el archivo y busca la línea:
   define('_PS_MODE_DEV_', false);
5. Cámbiala por:
   define('_PS_MODE_DEV_', true);
6. Guarda los cambios y sube el archivo de nuevo (si usaste FTP).

Ahora, al recargar tu tienda, en lugar de la página en blanco verás un mensaje de error detallado. Anota ese mensaje, ya que te indicará exactamente el problema (por ejemplo, un error de memoria o un archivo de módulo corrupto).

[WARNING] No olvides volver a poner _PS_MODE_DEV_ en false una vez resuelto el error. Dejarlo activo en una tienda en producción muestra información sensible a los visitantes.

Paso 2: Aumentar el límite de memoria PHP

El error más común detrás de la página en blanco es "Fatal error: Allowed memory size of X bytes exhausted". Esto significa que a PrestaShop se le acaba la memoria. En Plesk, solucionarlo es muy sencillo.

1. Entra en Plesk y ve a Hosting & DNS > Configuración de hosting para tu dominio.
2. Busca la sección Configuración de PHP.
3. Localiza la opción memory_limit. El valor recomendado para PrestaShop es 256M o incluso 512M si tienes muchos productos o módulos.
4. Cámbialo y guarda los cambios.

Si no encuentras esta opción, puede que necesites crearla manualmente. En la misma sección, busca Opciones adicionales de PHP y añade:
memory_limit = 512M

Paso 3: Deshabilitar módulos problemáticos por FTP

A veces, un módulo recién instalado o actualizado causa el conflicto. Si no puedes acceder al backoffice (panel de administración) de PrestaShop, puedes deshabilitar todos los módulos manualmente.

1. Conéctate por FTP o al administrador de archivos de Plesk.
2. Ve a la carpeta /modules de tu PrestaShop.
3. Renombra la carpeta del módulo sospechoso añadiendo _old al final. Por ejemplo, si el módulo se llama supermodulo, renómbralo a supermodulo_old.
4. Si no sabes cuál es el módulo problemático, puedes renombrar toda la carpeta modules a modules_old y crear una carpeta modules vacía. Esto desactivará TODOS los módulos y te permitirá entrar al backoffice. Luego, ve añadiendo las carpetas de los módulos originales de uno en uno para identificar al culpable.

Error 500 Internal Server Error en PrestaShop con Plesk

El error 500 es otro clásico. A diferencia de la página en blanco, aquí sí ves un mensaje, pero no da detalles. Las causas son similares, pero hay un par de pasos extra.

Revisar el archivo .htaccess

Un archivo .htaccess corrupto o con reglas incorrectas puede provocar un error 500.

1. Conecta por FTP a la raíz de tu tienda.
2. Busca el archivo .htaccess. Si existe, renómbralo a .htaccess_old.
3. Recarga tu tienda. Si el error desaparece, el problema era ese archivo.
4. Para regenerar un .htaccess limpio, entra al backoffice de PrestaShop (si puedes) y ve a Configuración de la tienda > Tráfico y SEO > URLs amigables. Simplemente guarda la configuración de nuevo (sin cambiar nada) y PrestaShop creará un nuevo .htaccess.

Verificar los permisos de archivos y carpetas

Los permisos incorrectos son una causa frecuente de errores en servidores Plesk.

1. En Plesk, ve a Hosting & DNS > Administrador de archivos.
2. Selecciona todas las carpetas y archivos de tu PrestaShop.
3. Haz clic en Permisos (o "Change Permissions").
4. Ajusta los permisos de la siguiente manera:
   • Archivos: 644
   • Carpetas: 755
5. Aplica los cambios a todas las subcarpetas y archivos.

[TIP] Si usas FTP, la mayoría de los clientes tienen una opción para "Aplicar cambios a todos los subdirectorios y archivos". Actívala para no tener que hacerlo uno por uno.

Error de conexión a la base de datos en Plesk

Este error suele aparecer después de mover la tienda de servidor o al cambiar la contraseña de la base de datos.

Localizar y corregir el archivo settings.inc.php

PrestaShop guarda los datos de conexión a la base de datos en el archivo app/config/parameters.php (en PrestaShop 1.7 en adelante) o en config/settings.inc.php (versiones anteriores, como 1.6).

1. Conéctate por FTP y busca el archivo correspondiente.
2. Ábrelo con un editor de texto (Bloc de notas, Notepad++, etc.).
3. Busca las líneas que definen el database_host, database_name, database_user y database_password.
4. Asegúrate de que coincidan EXACTAMENTE con los datos de tu base de datos en Plesk. Un error común es que el nombre de usuario de la base de datos en Plesk tenga un prefijo (ej: usuario_tienda) y en el archivo falte ese prefijo.
5. Guarda los cambios.

Crear la base de datos desde Plesk si no existe

Si el error persiste, es posible que la base de datos no esté creada o esté corrupta.

1. En Plesk, ve a Bases de datos.
2. Si la base de datos no aparece, créala con el mismo nombre que aparece en el archivo de configuración.
3. Añade un usuario (o usa el existente) y asígnale todos los privilegios.
4. Si tienes un backup de tu base de datos, impórtalo. Si no, tendrás que reinstalar PrestaShop desde cero (pérdida de datos).

Problemas con la versión de PHP en Plesk

PrestaShop es muy sensible a la versión de PHP. Usar una versión demasiado antigua o demasiado nueva puede causar errores PrestaShop Plesk.

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

1. Entra en Plesk y selecciona tu dominio.
2. Ve a Hosting & DNS > Configuración de hosting.
3. Busca la opción Versión de PHP.
4. Selecciona la versión recomendada para tu PrestaShop. Generalmente:
   • PrestaShop 1.6: PHP 5.6 o 7.0 (máximo 7.1)
   • PrestaShop 1.7: PHP 7.1, 7.2, 7.3 o 7.4
   • PrestaShop 8.x: PHP 7.4, 8.0 o 8.1
5. Guarda los cambios y prueba tu tienda.

[WARNING] Cambiar la versión de PHP puede romper módulos antiguos. Si después del cambio ves errores nuevos, vuelve a la versión anterior y actualiza los módulos primero.

Errores de módulos y temas incompatibles

Los módulos y temas son la causa número uno de dolores de cabeza en PrestaShop. Un módulo mal codificado puede tirar abajo toda la tienda.

Cómo identificar un módulo problemático sin entrar al backoffice

Si el error te impide acceder al panel de administración, puedes usar el método de renombrar carpetas que expliqué antes (Paso 3 de la página en blanco). Una vez dentro del backoffice, ve a Módulos > Gestor de módulos y desactiva los módulos sospechosos (los que instalaste recientemente o los que no son de confianza).

Forzar la compilación de temas desde Plesk

A veces, los errores visuales (CSS roto, layout desordenado) se deben a la caché de temas.

1. Conéctate por FTP y elimina el contenido de la carpeta /var/cache (en PrestaShop 1.7) o /cache (en versiones antiguas). No borres la carpeta en sí, solo su contenido.
2. En el backoffice, ve a Configuración de la tienda > Rendimiento.
3. Activa la opción Forzar compilación y desactiva Caché.
4. Guarda y recarga la tienda. Luego, vuelve a desactivar "Forzar compilación" para no ralentizar la tienda.

Preguntas frecuentes (FAQ) sobre errores PrestaShop Plesk

¿Por qué mi PrestaShop se vuelve lento de repente?

Puede deberse a varios factores: caché desactivada, módulos de terceros mal optimizados, una base de datos muy grande sin limpiar o que el servidor se haya quedado sin recursos. Te recomiendo revisar el panel de recursos de Plesk (CPU y RAM) y limpiar la caché de PrestaShop.

¿Qué hago si después de una actualización mi tienda da error 500?

Es muy común. Primero, verifica que la versión de PHP en Plesk sea compatible con la nueva versión de PrestaShop. Luego, deshabilita todos los módulos no nativos (los que no vienen con PrestaShop) siguiendo el método de renombrar carpetas. Si el error persiste, restaura una copia de seguridad y actualiza los módulos antes de actualizar el núcleo.

¿Cómo puedo hacer una copia de seguridad antes de tocar nada?

¡Esencial! En Plesk, ve a Herramientas y utilidades > Administrador de backups. Crea un backup completo de tu dominio y base de datos. Si algo sale mal, puedes restaurarlo en un solo clic.

¿Puedo usar Syspanel en lugar de Plesk para gestionar mi tienda?

Si te refieres a HestiaCP, debes saber que se llama "Syspanel" y suele accederse por el puerto 2106. Aunque es un panel válido, Plesk es más común para entornos de hosting compartido y tiene herramientas específicas para PrestaShop (como el instalador automático). Si tu servidor usa Syspanel (HestiaCP), el proceso de solución de errores es muy similar, solo cambia la interfaz del panel.

[INFO] Recuerda que si tu servidor usa Syspanel (HestiaCP), el acceso es por el puerto 2106 (ej: tudominio.com:2106). Las configuraciones de PHP y bases de datos se gestionan de manera análoga a Plesk.

¿Y si nada de esto funciona?

Respira hondo. Si has seguido todos los pasos y el error persiste, puede ser un problema más profundo del servidor (configuración de Apache/Nginx, módulos de Plesk corruptos, etc.). En ese caso, contacta con el soporte técnico de tu hosting. Ellos tienen acceso a los logs del servidor y podrán darte una respuesta precisa. Cuando les escribas, diles qué has probado y, si activaste el modo debug, adjúntales el mensaje de error exacto. Esto les ahorrará mucho tiempo y a ti te solucionarán el problema más rápido.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia y el método son tus mejores aliados. ¡Tu tienda volverá a estar online en poco tiempo!