Solucionar errores de PrestaShop en Plesk | Ayuda hosting

Si tienes una tienda online con PrestaShop alojada en un servidor con Plesk, es probable que en algún momento te encuentres con algún error inesperado. No te preocupes: la mayoría de estos problemas tienen soluciones sencillas que puedes aplicar tú mismo sin necesidad de ser un experto en servidores.

En esta guía práctica, vamos a recorrer los errores más comunes que aparecen al gestionar PrestaShop en Plesk, y te explicaremos paso a paso cómo solucionarlos. Todo explicado de forma clara, sin tecnicismos complicados.

¿Por qué ocurren errores en PrestaShop con Plesk?

PrestaShop es un sistema muy completo que necesita ciertos requisitos del servidor para funcionar correctamente. Plesk, por su parte, es uno de los paneles de control de hosting más populares, pero a veces su configuración predeterminada puede chocar con lo que necesita tu tienda.

Los errores más frecuentes suelen estar relacionados con:

Versiones de PHP incorrectas o incompatibles.
Límites de memoria o de ejecución demasiado bajos.
Permisos de archivos mal configurados.
Problemas con la base de datos (MySQL/MariaDB).
Extensiones de PHP desactivadas (como curl, gd, zip o mbstring).

Vamos a ver cada uno de ellos y cómo arreglarlos desde Plesk.

Error 1: "500 Internal Server Error" o pantalla en blanco

Este es uno de los más frustrantes porque no te da pistas claras. Aparece de repente y no ves nada en tu tienda.

Causa más común

El límite de memoria de PHP es demasiado bajo o hay un error en el archivo .htaccess.

Solución paso a paso

Accede a Plesk y ve a tu dominio.
Busca la sección "Configuración de PHP" (normalmente dentro de "Hosting y DNS" o en el menú del dominio).
Cambia las siguientes opciones:
- memory_limit a 256M o más.
- max_execution_time a 300.
- max_input_vars a 5000 (muy importante para PrestaShop).
Guarda los cambios y recarga tu tienda.

[TIP] Si el error persiste, revisa el archivo .htaccess en la raíz de tu PrestaShop. Puedes renombrarlo a .htaccess_old temporalmente para ver si el problema desaparece. Luego, desde el backoffice de PrestaShop, ve a "Configuración → Rendimiento" y regenera el archivo.

Error 2: "Error de conexión a la base de datos"

Este error suele aparecer al instalar PrestaShop o al migrar la tienda a un nuevo servidor.

Causa más común

Los datos de acceso a la base de datos (usuario, contraseña, nombre de la BD) no coinciden con los que tienes configurados en el archivo parameters.php.

Solución paso a paso

Conéctate a Plesk y ve a la sección "Bases de datos" de tu dominio.
Crea una nueva base de datos (o verifica que la existente funcione).
Anota el nombre de la base de datos, el usuario y la contraseña.
Abre el archivo /app/config/parameters.php de tu PrestaShop (puedes hacerlo desde el Administrador de archivos de Plesk).

Busca estas líneas y actualízalas con los datos correctos:

'database_host' => 'localhost',
'database_name' => 'nombre_de_tu_bd',
'database_user' => 'usuario_de_bd',
'database_password' => 'contraseña',

Guarda los cambios y vuelve a cargar tu tienda.

[WARNING] Si usas una base de datos remota, asegúrate de que el host no sea localhost, sino la IP del servidor de bases de datos.

Error 3: "El archivo no se puede subir" o límite de tamaño excedido

Al intentar subir imágenes, temas o módulos, PrestaShop te dice que el archivo es demasiado grande.

Causa más común

Los límites de subida de PHP están muy restringidos en el servidor.

Solución paso a paso

Entra en Plesk y ve a "Configuración de PHP" de tu dominio.
Aumenta los siguientes valores:
- upload_max_filesize a 64M (o más, según necesites).
- post_max_size a 64M.
- max_file_uploads a 20.
Guarda y prueba de nuevo.

[INFO] También puedes ajustar estos valores desde el archivo php.ini si tu plan de hosting lo permite, pero desde Plesk es más rápido y seguro.

Error 4: "El módulo no se puede instalar" o "Error al descomprimir"

Cuando intentas instalar un módulo o tema, aparece un error de compresión o de permisos.

Causa más común

La carpeta /modules o /themes no tiene permisos de escritura, o falta la extensión zip de PHP.

Solución paso a paso

Desde Plesk, ve al Administrador de archivos.
Navega a la carpeta raíz de tu PrestaShop.
Haz clic derecho sobre la carpeta modules y selecciona "Permisos".
Establece los permisos a 755 (o 0755) para carpetas y 644 para archivos.
Repite el mismo proceso con la carpeta themes y override.
Luego, verifica que la extensión zip esté activa en "Configuración de PHP" (busca extension=zip).
Guarda todo y vuelve a intentar la instalación.

[TIP] Si después de esto sigue sin funcionar, desactiva temporalmente el modo de seguridad de Plesk (si está activo) en la configuración del dominio.

Error 5: "La página no carga los estilos CSS" o "La tienda se ve sin diseño"

De repente tu PrestaShop se ve como texto plano, sin colores ni imágenes.

Causa más común

El modo de reescritura de URLs (URL rewriting) de Apache no está activo, o el archivo .htaccess está dañado.

Solución paso a paso

En Plesk, ve a "Configuración de Apache y nginx" de tu dominio (si tienes nginx como proxy).
Asegúrate de que la opción "Proxy mode" esté activada si usas nginx.
Luego, desde el backoffice de PrestaShop, ve a "Configuración → Rendimiento".
Haz clic en "Limpiar caché" y luego en "Regenerar archivo .htaccess".
Si no tienes acceso al backoffice, puedes subir el archivo .htaccess manualmente desde el Administrador de archivos de Plesk con este contenido básico:
```
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^(.*)$ /index.php [QSA,L]
</IfModule>
```

[WARNING] Si tu tienda usa SSL (https://), asegúrate de que el archivo .htaccess redirija correctamente de HTTP a HTTPS.

Error 6: "El carrito no se actualiza" o "Los productos no se añaden"

Un error muy molesto que puede hacer que pierdas ventas.

Causa más común

Las cookies de sesión no se están guardando correctamente, o hay un conflicto con la caché del servidor.

Solución paso a paso

En Plesk, ve a "Configuración de PHP" y asegúrate de que session.save_path tenga una ruta válida (normalmente /tmp o la carpeta temporal del usuario).
También revisa que session.gc_maxlifetime esté al menos en 1440 (24 minutos).
Limpia la caché de PrestaShop desde el backoffice o manualmente borrando la carpeta /var/cache (excepto el archivo .htaccess que contiene).
Prueba en otro navegador o en modo incógnito para descartar problemas locales.

[INFO] Si usas un CDN o plugin de caché como Varnish (común en Plesk), desactívalo temporalmente para ver si el problema se resuelve.

Error 7: "Se ha detectado un error de seguridad" o "Token inválido"

Este error suele aparecer al intentar acceder al backoffice o al realizar acciones administrativas.

Causa más común

La IP del servidor ha cambiado, o el token de seguridad de PrestaShop está desactualizado.

Solución paso a paso

Desde Plesk, ve a "Base de datos" y accede a phpMyAdmin.
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_configuration (o el prefijo que hayas usado).
Localiza la fila con name = 'PS_COOKIE_KEY' y elimínala (PrestaShop la regenerará automáticamente).
También puedes borrar la fila PS_CIPHER_ALGORITHM si existe.
Cierra sesión y vuelve a entrar al backoffice.

[WARNING] Antes de hacer cambios en la base de datos, siempre haz una copia de seguridad. Puedes hacerlo desde la sección "Bases de datos" de Plesk con un solo clic.

Error 8: "No se puede conectar con el servicio de correo"

Los emails de confirmación de pedido no llegan a tus clientes.

Causa más común

Plesk tiene su propio servidor de correo, pero la configuración SMTP de PrestaShop no está correcta.

Solución paso a paso

En Plesk, ve a "Configuración de correo" de tu dominio y asegúrate de que la dirección de email existe y funciona.
En el backoffice de PrestaShop, ve a "Parámetros avanzados → Email".
Selecciona "Usar servidor SMTP" y completa los datos:
- Servidor: localhost (o mail.tudominio.com).
- Puerto: 587 (o 465 con SSL).
- Usuario y contraseña: los de la cuenta de correo que creaste en Plesk.
Haz una prueba de envío.

[TIP] Si tu hosting usa Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106 y la configuración SMTP suele ser similar, pero verifica las credenciales en el panel de correo.

Preguntas frecuentes (FAQ)

¿Puedo cambiar la versión de PHP desde Plesk?

Sí, en la sección "Configuración de PHP" de tu dominio puedes elegir entre varias versiones. PrestaShop 1.7 necesita PHP 7.1 o superior, y PrestaShop 8 requiere PHP 8.0 o 8.1.

¿Qué hago si no encuentro la opción de PHP en Plesk?

Depende del plan de hosting. Si no ves la opción, contacta con tu proveedor y pídele que te habilite el "PHP Selector" o que te cambie la versión manualmente.

¿Cómo sé si mi hosting es compatible con PrestaShop?

Revisa los requisitos en la documentación oficial de PrestaShop. Básicamente necesitas: PHP 7.4+, MySQL 5.6+, Apache con mod_rewrite, y extensiones como gd, curl, zip, mbstring, openssl y pdo_mysql.

¿Puedo usar Syspanel (HestiaCP) en lugar de Plesk?

Sí, pero los pasos son diferentes. En Syspanel (puerto 2106) la configuración de PHP se hace desde la sección "Web" → "Dominios" → "Opciones avanzadas". Los errores comunes son similares, pero los nombres de las opciones pueden variar.

¿Y si después de todo el error sigue apareciendo?

Prueba a desactivar todos los módulos no esenciales desde el backoffice o renombrando la carpeta /modules a /modules_old (solo la de PrestaShop, no la de Plesk). Si el error desaparece, reactiva los módulos uno a uno para encontrar el culpable.

Consejos finales para mantener tu PrestaShop sano en Plesk

Mantén todo actualizado: Tanto PrestaShop como sus módulos y la versión de PHP en Plesk.
Haz copias de seguridad semanales: Desde Plesk puedes programar backups automáticos de tu web y base de datos.
Revisa los logs de error: En Plesk, ve a "Logs" de tu dominio para ver el archivo error_log. Ahí encontrarás pistas muy valiosas.
No abuses de módulos: Cada módulo adicional consume recursos y puede generar conflictos.
Usa un tema compatible: Los temas gratuitos o de fuentes no oficiales suelen dar más problemas.

Si sigues estos pasos, la mayoría de los errores comunes de PrestaShop en Plesk se resolverán sin necesidad de llamar al soporte técnico. Y si algo se te escapa, recuerda que siempre puedes consultar la documentación oficial de PrestaShop o preguntar en foros especializados.

¡Tu tienda online funcionará como un reloj suizo!