Errores comunes en PrestaShop con Plesk - Soluciones rápidas

Primeros pasos: identifica el origen del problema

Cuando tu tienda PrestaShop instalada en un servidor Plesk empieza a dar errores, lo más normal es sentirse abrumado. Pero no te preocupes: la mayoría de los problemas tienen una causa común y una solución clara. Antes de tocar nada, conviene que sepas que los problemas PrestaShop más habituales en Plesk suelen estar relacionados con permisos de archivos, configuración de PHP, caché o la base de datos.

Para diagnosticar correctamente, te recomiendo que actives el modo de depuración de PrestaShop. Esto te mostrará el error exacto en pantalla en lugar de una página en blanco. Para ello, edita el archivo config/defines.inc.php y cambia la línea que pone _PS_MODE_DEV_ a true.

[INFO] Si no sabes editar archivos, puedes usar el Administrador de archivos de Plesk desde el panel. Es muy intuitivo y no necesitas conocimientos de programación.

Una vez que veas el error concreto, podrás aplicar la solución adecuada. Vamos a repasar los casos más frecuentes y cómo resolverlos paso a paso.

Error de conexión a la base de datos

Este es, sin duda, uno de los errores PrestaShop más comunes. Si ves un mensaje como "Link to database cannot be established", significa que PrestaShop no puede conectarse a MySQL. Las causas suelen ser tres: credenciales incorrectas, el servicio MySQL está caído o la base de datos ha superado el límite de conexiones.

Solución paso a paso

Ve a Plesk y entra en Bases de datos.
Comprueba que la base de datos de tu tienda existe y que el nombre coincide con el que aparece en tu archivo app/config/parameters.php.
Verifica las credenciales de acceso (usuario y contraseña). Si no las recuerdas, puedes cambiarlas desde Plesk.
Reinicia el servicio MySQL desde Herramientas y ajustes > Servicios.

[WARNING] Si cambias la contraseña de la base de datos, deberás actualizar también el archivo parameters.php de PrestaShop con los nuevos datos. Si no, la conexión seguirá fallando.

En muchos casos, el problema viene de que el usuario de la base de datos no tiene todos los privilegios. Desde Plesk, edita el usuario y asegúrate de que tiene todos los permisos marcados.

Página en blanco o error 500

La temida pantalla blanca es otro de los problemas PrestaShop más reportados. Suele deberse a un error de PHP que no se muestra por estar la visualización de errores desactivada. También puede estar causado por un módulo incompatible o por falta de memoria.

Cómo solucionarlo

Activa el modo desarrollo como te explicaba antes para ver el error real.
Si el error menciona "Allowed memory size exhausted", necesitas aumentar el límite de memoria PHP.
Ve a Plesk > Configuración de PHP de tu dominio y sube el valor de memory_limit a al menos 256M.
Guarda los cambios y prueba de nuevo.

Si el problema persiste, desactiva temporalmente todos los módulos no esenciales. Puedes hacerlo desde el administrador de PrestaShop o, si no tienes acceso, renombrando la carpeta modules desde el Administrador de archivos de Plesk.

[TIP] Renombrar la carpeta modules a modules_backup desactiva todos los módulos de golpe. Si la tienda vuelve a funcionar, el problema era uno de ellos. Luego ve reactivándolos uno a uno.

Errores de caché en PrestaShop

La caché es una bendición para el rendimiento, pero a veces causa errores PrestaShop difíciles de diagnosticar. Si los cambios que haces no se reflejan, o ves contenido antiguo, probablemente la caché esté corrupta.

Limpiar la caché desde Plesk

Accede a Plesk > Administrador de archivos.
Navega hasta la carpeta var/cache de tu instalación de PrestaShop.
Elimina todo el contenido de la carpeta prod (o dev si estás en modo desarrollo).
También puedes borrar las carpetas cache y tmp si existen en la raíz.

Otra opción más cómoda es usar el propio panel de PrestaShop: ve a Parámetros avanzados > Rendimiento y pulsa el botón "Vaciar la caché".

[WARNING] Si después de limpiar la caché los errores continúan, puede que tengas un problema con los permisos de las carpetas. Plesk a veces no asigna los permisos correctos. Asegúrate de que las carpetas var/cache y var/logs tengan permisos 755 y los archivos 644.

Problemas con los permisos de archivos

Una causa muy frecuente de errores PrestaShop en Plesk es una mala asignación de permisos. Después de una actualización o una migración, es habitual que los archivos pierdan los permisos adecuados, lo que impide que la tienda lea o escriba ciertos archivos.

Cómo arreglar los permisos

Entra en Plesk > Administrador de archivos.
Selecciona la carpeta raíz de tu tienda.
Marca la opción Cambiar permisos y establece los siguientes valores:
- Carpetas: 755
- Archivos: 644
Aplica los cambios de forma recursiva.

[INFO] En Plesk, también puedes usar la opción "Reparar" desde el panel de la suscripción. Esto restablece los permisos por defecto de forma automática y suele resolver muchos problemas.

Si usas comandos SSH, puedes hacerlo con find y chmod, pero no es necesario si prefieres la interfaz gráfica.

Errores al actualizar PrestaShop

Actualizar PrestaShop puede ser un dolor de cabeza, y los problemas PrestaShop post-actualización son legión. Lo más común es que aparezcan errores de compatibilidad con módulos o que la base de datos no se haya actualizado correctamente.

Solución para fallos de actualización

Antes de actualizar, haz siempre una copia de seguridad completa de archivos y base de datos.
Si la actualización falla, restaura la copia de seguridad y prueba con una actualización manual.
Descarga la última versión de PrestaShop desde el sitio oficial.
Sustituye los archivos excepto la carpeta config, img y themes.
Ejecuta el script de actualización /install/upgrade desde el navegador.

[WARNING] Nunca actualices PrestaShop sin copia de seguridad. Si algo sale mal, podrías perder toda tu tienda. En Plesk puedes crear copias de seguridad fácilmente desde Herramientas y ajustes > Copias de seguridad.

Si después de actualizar ves errores de base de datos, ve a Parámetros avanzados > Base de datos y pulsa el botón "Reparar base de datos". Esto suele arreglar tablas corruptas.

Problemas con el envío de correos

PrestaShop no envía correos electrónicos es otro de los problemas PrestaShop más consultados. En Plesk, esto suele deberse a una mala configuración del servidor de correo o a que el puerto SMTP está bloqueado.

Configurar el correo correctamente

Ve a Parámetros avanzados > E-mail en el panel de PrestaShop.
Selecciona "Usar la función mail() de PHP" como método de envío.
Si eso no funciona, elige "Usar SMTP" y configura los datos de tu servidor de correo.
En Plesk, puedes encontrar los datos SMTP en Correo > Ajustes de correo.

[TIP] Si usas SMTP, asegúrate de que el puerto 587 (STARTTLS) o 465 (SSL) esté abierto en el firewall del servidor. Muchas veces el problema es solo eso.

Si los correos siguen sin llegar, revisa la carpeta de spam del destinatario. También puedes activar el registro de errores de correo en PrestaShop para ver qué está fallando exactamente.

Errores de imágenes que no cargan

Las imágenes rotas o que no se muestran son un problema estético pero también funcional. Esto suele pasar por falta de permisos en la carpeta img o por problemas con la generación de miniaturas.

Solución para imágenes

Verifica que la carpeta img tiene permisos 755.
Ve a Parámetros avanzados > Rendimiento y activa "Forzar la compilación" temporalmente.
Regenera las miniaturas desde Catálogo > Productos > Regenerar miniaturas.

[INFO] Si el problema comenzó tras una migración, es posible que las rutas de las imágenes estén mal en la base de datos. Puedes usar una consulta SQL para actualizarlas, pero si no te sientes cómodo, contacta con tu proveedor de hosting.

Errores de módulos incompatibles

Cuando instalas un módulo de terceros y la tienda empieza a fallar, el problema suele ser de compatibilidad. Esto es especialmente frecuente después de actualizar PrestaShop.

Cómo identificar el módulo problemático

Revisa el registro de errores en Parámetros avanzados > Registros.
Busca entradas que mencionen el nombre de un módulo.
Desactiva o elimina ese módulo desde el administrador.

Si no puedes acceder al administrador, renombra la carpeta del módulo sospechoso en modules desde Plesk. La tienda debería volver a funcionar.

[WARNING] No elimines la carpeta del módulo directamente. Mejor renómbrala para poder restaurarla si fuera necesario.

Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop en Plesk va tan lento?

La lentitud puede deberse a varios factores: caché desactivada, demasiados módulos activos, imágenes sin optimizar o un servidor con recursos limitados. Activa la caché de PrestaShop, optimiza las imágenes y desactiva módulos que no uses.

¿Cómo puedo saber si el problema es de Plesk o de PrestaShop?

Prueba a cargar una página estática en el mismo dominio. Si funciona, el problema es de PrestaShop. Si no, revisa la configuración de PHP y los servicios del servidor en Plesk.

¿Es seguro actualizar PrestaShop desde Plesk?

Sí, pero siempre con copia de seguridad previa. Plesk no actualiza PrestaShop automáticamente, así que tendrás que hacerlo manualmente o con un módulo de actualización.

¿Qué hago si no tengo acceso al administrador de PrestaShop?

Puedes desactivar módulos problemáticos renombrando carpetas o activar el modo desarrollo editando defines.inc.php desde el Administrador de archivos de Plesk.

¿Puedo usar Syspanel para gestionar mi PrestaShop?

Syspanel (el antiguo HestiaCP) es un panel de control alternativo que puedes usar para gestionar tu servidor. Se accede a través del puerto 2106. Te permite administrar bases de datos, dominios y archivos, aunque Plesk es más completo para hosting compartido.

Consejos finales para evitar futuros errores

La mejor manera de lidiar con los problemas PrestaShop es prevenirlos. Mantén siempre tu tienda actualizada, haz copias de seguridad periódicas y revisa los registros de Plesk de vez en cuando.

También es recomendable que configures un entorno de pruebas antes de aplicar cambios importantes. En Plesk puedes crear una subcopia de tu tienda en un subdominio para probar actualizaciones sin arriesgar la producción.

[TIP] Activa las notificaciones de Plesk para que te avise de problemas de disco, uso de CPU o errores de servicios. Así podrás actuar antes de que afecten a tu tienda.

Si a pesar de todo sigues con errores PrestaShop, no dudes en contactar con tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y podrán ayudarte a identificar la causa raíz. Con paciencia y método, casi cualquier problema tiene solución.