Errores comunes de PrestaShop en Plesk y cómo solucionarlos

Primeros pasos: ¿Qué está pasando con tu tienda?

Cuando tu tienda PrestaShop empieza a dar errores en un servidor Plesk, la tentación es entrar en pánico. Pero respira. La mayoría de los errores prestashop plesk tienen causas comunes y soluciones que puedes aplicar sin ser un experto.

Antes de tocar nada, te recomiendo hacer una copia de seguridad completa de tu sitio y de la base de datos. En Plesk, puedes hacerlo desde Sitios y dominios > Copias de seguridad. Esto te dará la tranquilidad de poder revertir cualquier cambio si algo sale mal.

Esta guía está pensada para que la sigas paso a paso, de lo más simple a lo más complejo. Así que vamos a por ello.

El error 500: El más temido y el más común

El error 500 (Internal Server Error) es, probablemente, el problema más habitual en prestashop plesk problemas. Te aparece una pantalla en blanco o un mensaje genérico, y no sabes por dónde empezar.

¿Por qué ocurre?

Las causas más frecuentes son:

Permisos de archivos incorrectos: PrestaShop necesita permisos específicos para leer y escribir archivos.
Un módulo o tema incompatible: Acabas de instalar algo y todo se ha roto.
El archivo .htaccess está corrupto: Este archivo controla la configuración del servidor.
Límite de memoria PHP agotado: Tu tienda necesita más memoria de la que tiene asignada.

Cómo solucionarlo paso a paso

Revisa el registro de errores de Plesk: Ve a Sitios y dominios > Registros. Busca el error más reciente. El mensaje te dará pistas. Si ves algo como "PHP Fatal error", sabrás que es un problema de código o memoria.
Aumenta el límite de memoria PHP:
- Ve a Sitios y dominios > Configuración de PHP.
- Busca la opción memory_limit. Cámbiala a 256M o incluso 512M.
- Guarda los cambios y prueba de nuevo.
Comprueba los permisos de archivos:
- Con un cliente FTP o el administrador de archivos de Plesk, asegúrate de que las carpetas tengan permisos 755 y los archivos 644.
- La carpeta var/cache y var/logs deben tener permisos 775 para que PrestaShop pueda escribir en ellas.
Renombra el archivo .htaccess:
- Conéctate por FTP o usa el administrador de archivos.
- Renombra .htaccess a .htaccess_old.
- Ve al back-office de PrestaShop y en Parámetros avanzados > Rendimiento, pulsa "Regenerar el archivo .htaccess".
- Si no puedes acceder al back-office, prueba a acceder a tu tienda. Si funciona, el problema era el .htaccess.

[WARNING] Si renombras el .htaccess, los enlaces amigables de tu tienda dejarán de funcionar hasta que lo regeneres. No te olvides de este paso.

Error de conexión a la base de datos

Otro clásico en solucionar prestashop plesk. Tu tienda muestra un mensaje como "Error de conexión a la base de datos" o "Link to database cannot be established".

Diagnóstico rápido

Abre el archivo app/config/parameters.php (en PrestaShop 1.7 y 8) o config/settings.inc.php (en PrestaShop 1.6).
Comprueba que los datos de conexión sean correctos: database_host, database_name, database_user y database_password.
Verifica que el nombre de la base de datos en Plesk coincide exactamente. A veces, Plesk añade un prefijo al nombre de usuario o a la base de datos.

Solución si los datos son correctos

Si los datos están bien, el problema puede ser que el servidor de base de datos esté caído o que el usuario no tenga permisos.

En Plesk, ve a Bases de datos y selecciona la base de datos de tu tienda.
Asegúrate de que el usuario asociado tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).
Si tienes acceso a Herramientas y ajustes > Servidor de base de datos, comprueba que MySQL o MariaDB esté en ejecución.

[TIP] Si cambiaste la contraseña de la base de datos recientemente desde Plesk, recuerda actualizarla también en el archivo parameters.php. Este es un error muy común.

El famoso "pantalla en blanco" (White Screen of Death)

La pantalla en blanco es un síntoma de un error fatal de PHP que no se muestra. Es frustrante porque no te da ninguna pista visual.

Activar el modo de depuración

Para ver el error real, tienes que activar el modo de depuración de PrestaShop:

Conéctate por FTP o usa el administrador de archivos de Plesk.
Abre el archivo config/defines.inc.php.
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cámbiala a define('_PS_MODE_DEV_', true);.
Guarda el archivo y recarga tu tienda. Ahora verás el error detallado en pantalla.

Errores típicos que verás

"Class not found": Un módulo o clase no se está cargando. Prueba a desactivar el módulo sospechoso desde la base de datos, o renombra la carpeta del módulo en /modules para desactivarlo.
"Allowed memory size exhausted": Ya lo solucionamos antes, pero si vuelve a aparecer, aumenta el límite a 512M o incluso 1G.

[INFO] Una vez hayas solucionado el problema, no olvides volver a poner define('_PS_MODE_DEV_', false); para que los errores no sean visibles para tus clientes.

Problemas con el caché de PrestaShop

El sistema de caché de PrestaShop puede causar errores extraños: productos que no aparecen, cambios que no se reflejan, o incluso errores 500.

Cómo limpiar el caché

Desde el back-office (si puedes acceder):
- Ve a Parámetros avanzados > Rendimiento.
- Pulsa el botón "Vaciar la caché" en la parte superior.
Desde el servidor (si no puedes acceder al back-office):
- Conéctate por FTP o usa el administrador de archivos.
- Borra el contenido de la carpeta var/cache (en PrestaShop 1.7 y 8) o cache (en PrestaShop 1.6). No borres la carpeta en sí, solo su contenido.

[TIP] Si después de limpiar el caché el problema persiste, desactiva el caché desde el archivo parameters.php o defines.inc.php temporalmente para descartar que sea la causa.

El error "No se puede conectar con el servidor de pago"

Este es un problema específico de tiendas online. Si tus clientes no pueden pagar, es una emergencia.

Causas comunes

Puertos bloqueados: PrestaShop necesita comunicarse con pasarelas de pago como PayPal o Stripe a través de puertos específicos (normalmente 443).
Certificado SSL caducado: Si tu certificado SSL ha expirado, la conexión segura falla.
Módulo de pago desactualizado: Los módulos antiguos pueden dejar de funcionar con las nuevas APIs de los proveedores.

Solución

Renueva tu certificado SSL: En Plesk, ve a Sitios y dominios > Certificados SSL/TLS y comprueba la fecha de caducidad. Si ha expirado, renuévalo o instala uno nuevo.
Actualiza los módulos de pago: Desde el back-office, ve a Módulos > Módulos y servicios y comprueba si hay actualizaciones disponibles.
Verifica los puertos: Si tienes un firewall, asegúrate de que los puertos 80 y 443 están abiertos. En Plesk, puedes revisarlo en Herramientas y ajustes > Firewall.

[WARNING] Si tu tienda no tiene SSL activo, la mayoría de las pasarelas de pago rechazarán la conexión. Activa SSL desde Plesk y configura la redirección de HTTP a HTTPS en el archivo .htaccess.

Errores al enviar correos electrónicos

PrestaShop envía correos para confirmar pedidos, recuperar contraseñas, etc. Si no llegan, tienes un problema.

Comprobar la configuración de correo

Ve a Parámetros avanzados > E-mail en el back-office.
Asegúrate de que el método de envío es "Usar la función mail() de PHP" o "Usar SMTP".
Si usas SMTP, verifica que el servidor, puerto, usuario y contraseña son correctos. Plesk suele mostrar estos datos en Sitios y dominios > Configuración de correo.

Solución si no envían

Prueba con SMTP: Si usas la función mail() de PHP y no funciona, cambia a SMTP. Los servidores de Plesk suelen tener un servidor de correo local en localhost con el puerto 25.
Revisa la bandeja de spam: A veces los correos se marcan como spam. Añade tu dominio a la lista blanca de tu cliente de correo.

[INFO] Si tu dominio tiene un registro SPF o DKIM mal configurado, los correos pueden ser rechazados. En Plesk, puedes configurar estos registros DNS desde Sitios y dominios > Configuración de DNS.

Problemas de rendimiento: La tienda va lenta

Una tienda lenta es un problema de diagnostico prestashop plesk que afecta a la experiencia de usuario y al SEO.

Qué puedes hacer

Activa la caché de PrestaShop: En Parámetros avanzados > Rendimiento, activa la caché y elige "Sistema de archivos" como método.
Habilita la compresión de páginas: En el mismo apartado, activa "Comprimir HTML" y "Comprimir CSS y JavaScript".
Activa la caché de PHP:
- En Plesk, ve a Sitios y dominios > Configuración de PHP.
- Busca las extensiones OPcache o APCu y actívalas si están disponibles.
Optimiza las imágenes: Las imágenes pesadas son el principal enemigo de la velocidad. Usa herramientas como ImageMagick o TinyPNG para comprimirlas sin perder calidad.

[TIP] Si tu tienda sigue lenta, considera activar la caché de Plesk (Nginx). Ve a Sitios y dominios > Configuración de Nginx y activa la opción de proxy de caché.

Errores de actualización de PrestaShop

Actualizar PrestaShop puede dar miedo, pero es necesario para la seguridad y el rendimiento.

El error "No se puede actualizar"

Comprueba los requisitos: PrestaShop 8 requiere PHP 7.2 o superior. En Plesk, puedes cambiar la versión de PHP en Sitios y dominios > Configuración de PHP.
Desactiva los módulos de terceros: Antes de actualizar, desactiva todos los módulos que no sean de PrestaShop. Puedes hacerlo desde el back-office o renombrando las carpetas en /modules.
Aumenta el tiempo de ejecución: Durante la actualización, PHP puede agotar el tiempo máximo. En la configuración de PHP, aumenta max_execution_time a 300 segundos.

[WARNING] Nunca actualices PrestaShop directamente desde el back-office si tienes muchos módulos de terceros. Haz una copia de seguridad y actualiza en un entorno de pruebas primero.

Errores de enlaces amigables (URLs)

Los enlaces amigables son importantes para el SEO. Si dejan de funcionar, tienes un problema.

Cómo solucionarlo

Ve a Parámetros avanzados > Rendimiento.
Pulsa "Regenerar el archivo .htaccess".
Ve a Parámetros avanzados > URLs y asegúrate de que la opción "Enlaces amigables" está activada.

Si el problema persiste, revisa que el módulo mod_rewrite de Apache esté activado en Plesk. Ve a Sitios y dominios > Configuración de Apache y compruébalo.

[INFO] Si tu servidor usa Nginx como proxy, asegúrate de que la configuración de Nginx permite la reescritura de URLs. En Plesk, esto se gestiona automáticamente, pero a veces hay que añadir reglas manuales.

Preguntas frecuentes (FAQ)

¿Por qué mi tienda PrestaShop da error 500 después de cambiar la versión de PHP?

Es muy común. Al cambiar la versión de PHP, algunos módulos o temas pueden dejar de ser compatibles. Prueba a desactivar los módulos de terceros y a limpiar el caché. Si el error persiste, vuelve a la versión anterior de PHP.

¿Cómo puedo saber si mi base de datos está corrupta?

Si ves errores como "Table doesn't exist" o "MySQL server has gone away", puede que la base de datos esté corrupta. En Plesk, ve a Bases de datos, selecciona tu base de datos y usa la herramienta "Reparar" o ejecuta el comando mysqlcheck desde SSH.

¿Qué hago si no puedo acceder al back-office de PrestaShop?

Puedes intentar acceder directamente a /admin en tu navegador. Si no funciona, el problema puede ser de permisos o de caché. Desactiva el módulo de seguridad de PrestaShop renombrando el archivo admin/.htaccess temporalmente.

¿Es normal que los correos de PrestaShop lleguen a la carpeta de spam?

Sí, es bastante común. Configura correctamente los registros SPF y DKIM en Plesk para mejorar la reputación de tu dominio. También puedes usar un servicio SMTP como Gmail o SendGrid para mejorar la entrega.

¿Cuánto tiempo debo esperar después de limpiar el caché?

Los cambios deberían ser inmediatos. Si no ves cambios, prueba a limpiar el caché del navegador o a usar el modo incógnito.

Conclusión: Paciencia y método

Los errores prestashop plesk pueden parecer abrumadores, pero con un diagnóstico metódico, la mayoría se resuelven en minutos. Recuerda siempre:

Haz copias de seguridad antes de cualquier cambio.
Revisa los registros de errores de Plesk.
Aumenta la memoria PHP y el tiempo de ejecución si tienes dudas.
Limpia el caché de PrestaShop después de cualquier modificación.
No tengas miedo de desactivar módulos para aislar el problema.

Si después de seguir esta guía sigues teniendo prestashop plesk problemas, no dudes en contactar con tu proveedor de hosting o con un desarrollador especializado. A veces, el problema requiere un análisis más profundo del servidor, y es mejor dejarlo en manos de expertos.

Espero que esta guía te haya sido de ayuda. ¡Tu tienda online volverá a funcionar en un abrir y cerrar de ojos!