Solucionar errores de PrestaShop en Plesk | Guía fácil

Si tienes una tienda online con PrestaShop alojada en un servidor que utiliza Plesk como panel de control, es probable que en algún momento te encuentres con algún error. No te preocupes, es algo normal. La combinación PrestaShop Plesk es muy potente, pero a veces pueden surgir conflictos de configuración, permisos o recursos. En esta guía extensa y práctica, vamos a recorrer los errores PrestaShop más frecuentes en entornos Plesk y, lo más importante, te enseñaremos cómo solucionar PrestaShop paso a paso, con un lenguaje claro y directo.

1. Error de conexión a la base de datos

Uno de los Plesk PrestaShop problemas más habituales es el temido "Error de conexión a la base de datos". Esto suele aparecer cuando la tienda no puede comunicarse con MySQL. Las causas más comunes son cambios en la contraseña, corrupción del archivo de configuración o que el servicio de base de datos esté caído.

Solución paso a paso:

Verifica que MySQL esté funcionando
Accede a Plesk, ve a Herramientas y Ajustes > Gestor de Servicios. Busca "MySQL" y asegúrate de que esté en verde (activo). Si no, reinícialo.
Revisa el archivo app/config/parameters.php
Este archivo contiene los datos de conexión. Conéctate por FTP o el administrador de archivos de Plesk y ábrelo. Busca estas líneas:
```
'database_host' => 'localhost',
'database_name' => 'tu_basededatos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',
```
Si has cambiado la contraseña de la base de datos desde Plesk, actualízala aquí. Si no recuerdas la contraseña, en Plesk ve a Bases de Datos, selecciona la base de tu PrestaShop y usa "Cambiar contraseña".
Prueba la conexión manualmente
Desde la herramienta phpMyAdmin de Plesk (encontrarás el acceso en la sección Bases de Datos) intenta iniciar sesión con los mismos datos. Si falla, el problema está en la base de datos, no en PrestaShop.

[TIP] Si después de cambiar la contraseña el error persiste, limpia la caché de PrestaShop. Puedes hacerlo desde el panel de administración en Configuración Avanzada > Rendimiento > Limpiar caché. Si no puedes acceder, borra manualmente la carpeta /var/cache (excepto el archivo .htaccess).

2. Error 500 Internal Server Error

Este error genérico puede deberse a problemas de permisos, archivos corruptos o un plugin incompatible. Es uno de los errores PrestaShop más frustrantes porque no da detalles.

Solución paso a paso:

Activa el modo debug de PrestaShop
Edita el archivo /config/defines.inc.php y cambia:
```
define('_PS_MODE_DEV_', false);
```
a:
```
define('_PS_MODE_DEV_', true);
```
Esto mostrará el error real en pantalla. Si no ves nada, revisa los logs de error de Plesk en Herramientas y Ajustes > Logs de Errores.
Revisa los permisos de archivos y carpetas
En Plesk, ve a Archivos y selecciona la carpeta raíz de tu PrestaShop. Asegúrate de que los permisos sean 755 para carpetas y 644 para archivos. Puedes usar el botón "Cambiar permisos" para aplicar recursivamente.
Desactiva módulos conflictivos
Si el error apareció tras instalar un módulo, renombra la carpeta del módulo en /modules (por ejemplo, añadiendo "_old") para desactivarlo temporalmente. Luego limpia la caché.

[WARNING] No dejes el modo debug activo en producción. Una vez resuelto el error, vuelve a poner _PS_MODE_DEV_ en false.

3. Página en blanco (White Screen of Death)

Una página completamente en blanco suele indicar un error de PHP silencioso. Es otro clásico entre los Plesk PrestaShop problemas.

Solución paso a paso:

Aumenta el límite de memoria PHP
En Plesk, ve a Configuración de PHP (dentro del dominio de tu tienda). Busca memory_limit y cámbialo a al menos 256M o 512M. También ajusta max_execution_time a 300.
Revisa los logs de error de PHP
En la misma sección de configuración PHP, activa display_errors a On temporalmente. Luego recarga la página. Si ves un error como "Allowed memory size exhausted", el problema era la memoria.
Desactiva todos los módulos no esenciales
Si no puedes acceder al panel de administración, usa FTP para renombrar la carpeta /modules a /modules_backup y crea una nueva carpeta /modules vacía. Si la página vuelve a funcionar, el conflicto está en algún módulo. Ve restaurando uno por uno.

[INFO] Si tu PrestaShop es muy antiguo (versiones < 1.7), considera actualizarlo. Las versiones viejas tienen problemas de compatibilidad con PHP 7.4 o superior, que es lo que suele usar Plesk hoy en día.

4. Error de carga lenta o timeout

Si tu tienda tarda mucho en cargar o da error "504 Gateway Timeout", el problema suele ser de recursos o configuración del servidor.

Solución paso a paso:

Optimiza la base de datos
Desde phpMyAdmin, selecciona la base de datos de PrestaShop y usa la opción "Optimizar tabla". También puedes instalar el módulo gratuito "PrestaShop Cleaner" para limpiar tablas temporales.
Habilita la caché de PrestaShop
En el panel de administración, ve a Configuración Avanzada > Rendimiento. Activa la caché (recomendada: "Sistema de archivos") y la compresión CCC (Combine, Compress and Cache) para CSS y JavaScript.
Aumenta los límites de tiempo en Plesk
En Configuración de PHP, sube max_execution_time a 300 y max_input_time a 300. También verifica en Apache & Nginx Settings (si usas Nginx como proxy) que proxy_read_timeout sea al menos 300 segundos.

[TIP] Si tu hosting compartido es muy limitado, considera migrar a un VPS o un plan optimizado para PrestaShop. Plesk suele funcionar mejor con al menos 2 GB de RAM.

5. Error de permisos al subir imágenes o módulos

Cuando intentas subir una imagen de producto o instalar un módulo y recibes un error de "no se puede escribir en el directorio", es un problema clásico de permisos.

Solución paso a paso:

Asigna el usuario correcto del sistema
En Plesk, ve a Hosting > Configuración de Hosting. Busca "Permisos del sistema" y asegúrate de que el usuario del sistema tenga permisos de escritura. Marca las opciones "Acceso a la shell" y "Ejecución de scripts PHP como usuario del sistema" si es necesario.
Corrige permisos de carpetas específicas
Las carpetas problemáticas suelen ser:
- /img (para imágenes)
- /modules (para módulos)
- /themes (para temas)
- /var (para caché)
  Usa el administrador de archivos de Plesk para dar permisos 755 a carpetas y 644 a archivos. Si el error persiste, prueba con 777 temporalmente (pero luego vuelve a 755 por seguridad).
Desactiva el modo de seguridad de PHP
En Configuración de PHP, busca open_basedir y asegúrate de que no esté restringiendo las carpetas de PrestaShop. Si está activo, desactívalo o añade las rutas necesarias.

[WARNING] Nunca dejes permisos 777 en producción. Solo úsalos para pruebas y luego revierte.

6. Error de SSL/HTTPS (contenido mixto)

Después de instalar un certificado SSL en Plesk, tu tienda puede mostrar el candado roto o advertencias de "contenido mixto". Esto ocurre cuando algunos recursos (imágenes, CSS) se cargan aún por HTTP.

Solución paso a paso:

Configura PrestaShop para forzar HTTPS
En el panel de administración, ve a Configuración de la tienda > Parámetros generales. Activa "Forzar SSL" y "Forzar SSL en todas las páginas".

Actualiza la URL en la base de datos
Si tienes imágenes o enlaces antiguos con HTTP, ejecuta esta consulta SQL en phpMyAdmin (reemplaza ps_ por tu prefijo):

UPDATE ps_configuration SET value = 'https://tudominio.com' WHERE name IN ('PS_SHOP_DOMAIN', 'PS_SHOP_DOMAIN_SSL');
UPDATE ps_shop_url SET domain = 'tudominio.com', domain_ssl = 'tudominio.com';

Limpia la caché del navegador y de PrestaShop
A veces el navegador guarda la versión antigua. Limpia la caché desde el panel de administración y también en tu navegador.

[INFO] Si usas un CDN como Cloudflare, asegúrate de que esté configurado para pasar el tráfico HTTPS correctamente. En Plesk, puedes instalar el módulo "SSL It!" para gestionar certificados fácilmente.

7. Error al enviar correos (formularios de contacto, pedidos)

PrestaShop utiliza PHP mail() por defecto, y en muchos servidores Plesk esto está deshabilitado o mal configurado, causando que los correos no se envíen.

Solución paso a paso:

Configura SMTP en PrestaShop
Ve a Configuración de la tienda > Parámetros de contacto > Configuración de correo electrónico. Cambia el método de envío a "Configuración SMTP" e introduce los datos de tu servidor de correo (puedes usar el mismo de Plesk o Gmail/Outlook). Por ejemplo:
- Servidor SMTP: smtp.tudominio.com
- Puerto: 587
- Autenticación: Sí
- Usuario y contraseña: los de tu cuenta de correo
Prueba el envío manualmente
Usa la herramienta "Enviar un correo de prueba" en la misma sección. Si no funciona, verifica que el puerto SMTP no esté bloqueado por el firewall de Plesk (ve a Herramientas y Ajustes > Firewall y asegúrate de que el puerto 587 esté abierto).
Instala un módulo de correo
Si el problema persiste, instala el módulo gratuito "Mail Alert" o "Sendinblue" para gestionar los correos transaccionales.

[TIP] Para evitar que los correos caigan en spam, configura correctamente los registros SPF y DKIM en el DNS de tu dominio. Plesk tiene asistentes para esto en Correo > Configuración de DNS.

8. Error de actualización de PrestaShop

Actualizar PrestaShop desde versiones antiguas puede dar errores de compatibilidad con PHP o módulos. Es uno de los errores PrestaShop más delicados.

Solución paso a paso:

Verifica los requisitos del sistema
Antes de actualizar, comprueba en Configuración Avanzada > Información del Sistema que tu servidor cumple con los requisitos de la nueva versión (PHP 7.4+ para PrestaShop 1.7.8, PHP 8.0+ para versiones más recientes). En Plesk, puedes cambiar la versión de PHP desde Configuración de PHP.
Haz una copia de seguridad completa
En Plesk, ve a Herramientas y Ajustes > Gestor de Copias de Seguridad. Crea una copia de la base de datos y los archivos. También puedes usar el módulo "PrestaShop Backup" desde el panel de administración.
Usa el asistente de actualización
Descarga el módulo "1-Click Upgrade" desde el marketplace de PrestaShop. Sigue los pasos: primero actualiza a la última versión menor de tu rama, luego a la siguiente. No saltes versiones.

[WARNING] Si la actualización falla, restaura la copia de seguridad desde Plesk. Nunca intentes "forzar" una actualización manual si no estás seguro.

9. Error de redirección infinita (bucle)

A veces, al configurar URLs amigables o SSL, PrestaShop entra en un bucle de redirecciones que impide cargar la tienda.

Solución paso a paso:

Limpia el archivo .htaccess
Conéctate por FTP, renombra el archivo .htaccess a .htaccess_old y luego genera uno nuevo desde el panel de administración de PrestaShop en Configuración Avanzada > Rendimiento > Generar .htaccess.
Verifica la configuración de redirección en Plesk
En Hosting > Configuración de Hosting, asegúrate de que no haya reglas de redirección personalizadas que entren en conflicto. Desactiva temporalmente cualquier redirección 301.
Revisa las URLs en la base de datos
Con phpMyAdmin, ejecuta:
```
SELECT * FROM ps_configuration WHERE name LIKE '%URL%';
```
Asegúrate de que PS_REWRITING_SETTINGS esté en 1 si usas URLs amigables.

[INFO] Si usas Nginx como servidor web (común en Plesk), las reglas de reescritura se configuran en Apache & Nginx Settings. Añade las reglas de PrestaShop manualmente si es necesario.

10. Preguntas frecuentes (FAQ)

¿Por qué mi PrestaShop en Plesk da error 403 Forbidden?

Esto suele deberse a permisos incorrectos en la carpeta raíz. Ve a Archivos en Plesk, selecciona la carpeta de tu dominio y dale permisos 755. También verifica que el archivo index.php exista.

¿Cómo puedo cambiar la versión de PHP para PrestaShop en Plesk?

En Configuración de PHP dentro del dominio, selecciona la versión deseada. PrestaShop 1.7 funciona mejor con PHP 7.4, y PrestaShop 8 con PHP 8.0 o 8.1.

¿Puedo usar Syspanel para gestionar mi PrestaShop?

Sí, si tu servidor usa Syspanel (el nombre del panel HestiaCP), el acceso es por el puerto 2106. Los pasos para solucionar errores son similares, pero la gestión de bases de datos y archivos se hace desde la interfaz de Syspanel.

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

Si olvidaste la contraseña, usa la opción "¿Olvidaste tu contraseña?" en la página de login. Si eso falla, desde phpMyAdmin ejecuta:

UPDATE ps_employee SET passwd = MD5('cocina123') WHERE email = 'tu@email.com';

Luego inicia sesión con la contraseña cocina123 y cámbiala.

¿Cómo limpio la caché de PrestaShop sin acceso al panel?

Borra manualmente el contenido de la carpeta /var/cache (excepto el archivo .htaccess). También puedes eliminar la carpeta /cache/smarty/compile para forzar la regeneración de las plantillas.

Conclusión

Como has visto, la mayoría de los Plesk PrestaShop problemas tienen solución con unos pocos pasos lógicos. La clave está en entender que Plesk es un panel muy completo pero que a veces requiere ajustes finos en permisos, configuración PHP y base de datos. No tengas miedo de meterte en los archivos de configuración o usar phpMyAdmin