Solucionar errores de PrestaShop en Plesk | Guía práctica

Entendido. Aquí tienes el artículo extenso sobre errores comunes en PrestaShop con Plesk, siguiendo todas las reglas de formato y contenido solicitadas.

Introducción: ¿Por qué aparecen estos errores?

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 mensaje de error inesperado. No te preocupes, es algo muy habitual, sobre todo al principio. La combinación de un gestor de contenido potente como PrestaShop con un panel de control como Plesk es excelente, pero a veces la configuración del servidor y los requisitos de la tienda no se alinean del todo.

En esta guía, vamos a repasar los errores PrestaShop Plesk más comunes, te explicaremos por qué ocurren y, lo más importante, te daremos pasos claros y sencillos para solucionar PrestaShop Plesk de una vez por todas. No necesitas ser un experto en informática; solo sigue las instrucciones al pie de la letra.

Error 1: El "Error 500 Internal Server Error" o Pantalla Blanca

Este es, sin duda, uno de los PrestaShop Plesk problemas más frustrantes. De repente, tu tienda se queda en blanco o muestra un escueto "Error 500". Generalmente, esto se debe a un conflicto con los archivos .htaccess o a un límite de memoria de PHP demasiado bajo.

¿Por qué ocurre?

PrestaShop utiliza un archivo .htaccess para gestionar las URLs amigables y la seguridad. Si este archivo se corrompe (por ejemplo, al desactivar la opción de URLs amigables en el panel de control), el servidor no sabe cómo procesar las peticiones y se bloquea. Otra causa común es que el script de PrestaShop intente usar más memoria de la que el servidor le permite.

Solución paso a paso

Regenera el archivo .htaccess desde el panel de administración de PrestaShop.
- Accede a tu back office de PrestaShop (por ejemplo, tutienda.com/admin1234).
- Ve a Configuración de la tienda > Tráfico y SEO > URLs amigables.
- Asegúrate de que la opción "URLs amigables" esté activada. Si no lo está, actívala y guarda.
- Haz clic en el botón "Guardar" de nuevo para forzar la regeneración del archivo.
- Si no puedes acceder al back office, tendrás que hacerlo manualmente. Conéctate a Plesk, ve a "Administrador de archivos", busca la carpeta raíz de tu tienda (normalmente httpdocs o public_html), localiza el archivo .htaccess, renómbralo a .htaccess_old y luego intenta acceder a la tienda. Esto forzará a PrestaShop a crear uno nuevo.
Aumenta el límite de memoria de PHP.
- En Plesk, ve a Hosting y DNS > Configuración de hosting para tu dominio.
- Busca la sección Configuración de PHP.
- Cambia el valor de memory_limit a 256M o incluso 512M. También es buena idea ajustar max_execution_time a 120 y upload_max_filesize a 64M.
- Guarda los cambios y recarga la página de tu tienda.

[TIP] Si el error persiste, revisa los logs de error del dominio en Plesk (en la sección "Logs"). Te darán una pista mucho más precisa sobre qué línea de código está fallando.

Error 2: Problemas con la Base de Datos (Error de conexión o tabla dañada)

Otro de los errores PrestaShop Plesk típicos es ver un mensaje como "Error de conexión a la base de datos" o "La tabla 'ps_XXXX' no existe". Esto suele ocurrir después de una migración, una actualización fallida o por un corte de luz en el servidor.

¿Por qué ocurre?

PrestaShop guarda toda su información (productos, pedidos, clientes) en una base de datos MySQL. Si esta base de datos se corrompe o los datos de conexión no son correctos, la tienda no puede funcionar.

Solución paso a paso

Verifica los datos de conexión.
- Conéctate a Plesk y ve a Bases de datos. Localiza la base de datos de tu PrestaShop.
- Anota el nombre de la base de datos, el usuario y la contraseña.
- Ahora, ve al Administrador de archivos y busca el archivo app/config/parameters.php en la raíz de tu tienda.
- Ábrelo y comprueba que los valores de database_host, database_name, database_user y database_password coinciden exactamente con los que tienes en Plesk.
- Si no coinciden, corrígelos y guarda el archivo.
Repara las tablas dañadas.
- En la misma sección de Bases de datos de Plesk, haz clic en el nombre de tu base de datos para abrir phpMyAdmin.
- Selecciona todas las tablas (marcando la casilla de arriba del todo).
- En el menú desplegable "Con selección:", elige la opción "Reparar tabla".
- phpMyAdmin intentará reparar cualquier tabla corrupta automáticamente.

[WARNING] Si la reparación falla, es posible que necesites restaurar una copia de seguridad reciente de la base de datos. Siempre es recomendable tener copias de seguridad automatizadas en tu plan de hosting.

Error 3: El Módulo de "HestiaCP" (Syspanel) no se conecta o da error

A veces, al gestionar un servidor, se menciona un panel de control alternativo como "HestiaCP". Si tu proveedor de hosting usa este sistema, recuerda que en nuestra documentación lo llamamos Syspanel. Un error común es intentar acceder a él por el puerto equivocado o tener problemas de permisos.

¿Por qué ocurre?

Syspanel (HestiaCP) tiene su propia interfaz y puerto de administración. Si intentas acceder por el puerto estándar de Plesk (8443) o por el 8080, no funcionará. Además, puede que los scripts de instalación de PrestaShop no tengan permisos para escribir en ciertas carpetas si la configuración de Syspanel es demasiado restrictiva.

Solución paso a paso

Accede correctamente a Syspanel.
- La URL para acceder a tu panel Syspanel es: https://tudominio.com:2106
- Recuerda que el puerto es el 2106, no el 8443 de Plesk.
Ajusta los permisos de las carpetas desde Syspanel.
- Si tienes problemas de escritura (por ejemplo, al instalar un tema o módulo), inicia sesión en Syspanel.
- Busca la sección de "Web" o "Dominios" y selecciona tu dominio.
- Busca una opción que diga "Permisos de archivos" o "Reajustar permisos".
- Aplica la configuración para que las carpetas cache, img, modules, themes y upload tengan permisos de escritura para el usuario del sistema (generalmente 755 para carpetas y 644 para archivos, pero la herramienta de Syspanel lo hará automáticamente).

[INFO] Syspanel (HestiaCP) es muy seguro, pero a veces es demasiado restrictivo por defecto. Usar su herramienta de reajuste de permisos suele resolver el 90% de los problemas de escritura.

Error 4: El Catálogo se ve en blanco o con errores de JavaScript

Este es otro de los PrestaShop Plesk problemas que más afectan a la experiencia de usuario. Puede que la página principal cargue bien, pero al entrar en una categoría o producto, todo se vea en blanco o con los elementos desordenados.

¿Por qué ocurre?

Suele deberse a que la opción "Forzar compilación" del motor de plantillas está desactivada y PrestaShop está usando una plantilla en caché que está corrupta. También puede ser un problema con la combinación de archivos CSS/JS.

Solución paso a paso

Limpia la caché del motor de plantillas desde el back office.
- Ve a Configuración avanzada > Rendimiento.
- En la sección "Caché", asegúrate de que la opción "Forzar compilación" esté activada (marca el "Sí").
- También activa la opción "Forzar la compilación de los archivos JavaScript" y "Forzar la compilación de los archivos CSS".
- Haz clic en "Guardar".
- Ahora, en la parte superior, verás un botón que dice "Limpiar la caché". Haz clic en él.
- Después de limpiar, puedes volver a desactivar "Forzar compilación" para que la tienda vaya más rápida, pero déjalo activado mientras solucionas el problema.
Desactiva la combinación de archivos CSS/JS.
- En la misma página de Rendimiento, busca la sección "Administrador de plantillas".
- Asegúrate de que "Minimizar CSS" y "Minimizar JavaScript" estén en "No".
- Guarda los cambios. A veces, la combinación de archivos en servidores con poco recursos o configuraciones específicas de Plesk causa conflictos.

Error 5: Problemas al enviar correos electrónicos (Formulario de contacto o confirmación de pedido)

Es muy común que los dueños de tiendas nos digan: "No me llegan los correos de nuevos pedidos". Este es un clásico error PrestaShop Plesk relacionado con la configuración del envío de correo.

¿Por qué ocurre?

PrestaShop intenta enviar correos usando la función mail() de PHP, pero muchos servidores Plesk bloquean esta función por seguridad o la tienen mal configurada. La solución es usar un servidor SMTP externo (como Gmail, Outlook o el propio servicio de correo de tu hosting).

Solución paso a paso

Configura un servidor SMTP en PrestaShop.
- Ve a Configuración avanzada > Correo electrónico.
- Cambia el "Método de envío" de "Usar la función mail() de PHP" a "Configurar SMTP".
- Ahora tienes que rellenar los datos de tu servidor SMTP. Si usas el servicio de correo de tu hosting, los datos suelen ser:
  - Servidor SMTP: mail.tudominio.com
  - Usuario: tuemail@tudominio.com
  - Contraseña: La de tu correo electrónico.
  - Puerto: 587 (con cifrado TLS) o 465 (con cifrado SSL).
- Guarda los cambios y haz clic en "Enviar un correo de prueba" para verificar que funciona.
Si usas Gmail o Outlook.
- Los datos del servidor SMTP son diferentes. Para Gmail:
  - Servidor SMTP: smtp.gmail.com
  - Puerto: 587
  - Cifrado: TLS
  - Usuario: tucorreo@gmail.com
  - Contraseña: Debes generar una "Contraseña de aplicación" en tu cuenta de Google, no usar tu contraseña normal.

[WARNING] Si tu hosting tiene un cortafuegos muy restrictivo, puede bloquear las conexiones SMTP salientes al puerto 587 o 465. En ese caso, contacta con tu proveedor de hosting para que te indique el puerto correcto o te abran esa opción.

Preguntas Frecuentes (FAQ)

¿Cómo accedo a phpMyAdmin en Plesk para reparar la base de datos?

En Plesk, ve a Bases de datos, haz clic en el nombre de tu base de datos y luego en el botón "phpMyAdmin". Dentro, podrás seleccionar las tablas y usar la opción "Reparar tabla".

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

Si el error te impide entrar, tendrás que hacer las correcciones manualmente a través del Administrador de archivos de Plesk. Busca el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Esto mostrará los errores detallados en la pantalla. Después, renómbralo a false de nuevo.

¿Es necesario desactivar "Forzar compilación" después de solucionar el error?

Sí, es recomendable. Dejar "Forzar compilación" activado consume muchos recursos del servidor porque vuelve a compilar la plantilla en cada carga de página. Una vez solucionado el problema, desactívalo para que la tienda cargue más rápido.

¿Por qué Syspanel (HestiaCP) es diferente a Plesk?

Son dos paneles de control de hosting diferentes. Plesk es más común en entornos Windows y Linux comerciales, mientras que Syspanel (HestiaCP) es una alternativa gratuita y muy segura para Linux. La principal diferencia para ti es el puerto de acceso (2106 para Syspanel) y la interfaz.

¿Los errores de PrestaShop pueden deberse a un módulo incompatible?

Absolutamente. Si has instalado un módulo recientemente y empezaron los problemas, desactívalo desde Módulos > Catálogo de módulos. Si no puedes acceder al back office, renombra la carpeta del módulo en /modules a través del Administrador de archivos de Plesk (por ejemplo, de micodigo a micodigo_old).

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que la clave para solucionar PrestaShop Plesk es ir paso a paso, identificar primero el error y luego aplicar la solución correcta. Si el problema persiste, no dudes en contactar con nuestro equipo de soporte técnico. ¡Estamos aquí para ayudarte a que tu tienda online funcione a la perfección!