Errores comunes PrestaShop | Soluciones en cPanel/Plesk

¿Tu tienda PrestaShop va lenta, muestra pantallas en blanco o directamente no carga? No te preocupes, es mucho más común de lo que piensas. Cuando trabajamos con un hosting compartido (como cPanel o Plesk), los errores suelen tener causas muy similares y, sobre todo, soluciones que puedes aplicar tú mismo sin ser un experto.

En esta guía vamos a desgranar los errores comunes en PrestaShop y te daré la solución de errores PrestaShop paso a paso, tanto si tu panel de control es cPanel como si es Plesk. Al final, tendrás un manual práctico para rescatar tu tienda en minutos.

Antes de empezar: La regla de oro del backup

[WARNING]
No toques nada sin hacer una copia de seguridad completa (archivos y base de datos). Un error al editar un archivo de configuración puede dejar tu tienda inservible. La mayoría de los paneles (cPanel y Plesk) tienen asistentes para hacer backups en un clic. Hazlo siempre antes de probar cualquier solución.

Errores comunes en PrestaShop y sus causas generales

La mayoría de los problemas que verás en foros y soportes técnicos se reducen a tres grandes grupos:

Errores de permisos de archivos (muy típico en cPanel).
Problemas con la caché o las sesiones (común en ambos paneles).
Errores de configuración de PHP o la base de datos (frecuente en Plesk).

Vamos a ver cómo atacar cada uno de estos frentes.

Solución de errores en cPanel

cPanel es el panel más popular en el mundo del hosting compartido. Su estructura de carpetas es clara, pero a veces los permisos se vuelven restrictivos.

1. El error 500 o "Internal Server Error" en cPanel

Este es, sin duda, uno de los errores comunes PrestaShop más frustrantes porque no te dice nada. La causa suele ser un archivo .htaccess corrupto o permisos de archivos incorrectos.

Solución paso a paso:

Accede a tu cPanel y entra en el Administrador de archivos.
Ve a la carpeta public_html (o donde tengas instalada la tienda).
Busca el archivo .htaccess. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Renómbralo a .htaccess.bak. Esto lo desactiva temporalmente.
Vuelve a cargar tu tienda. Si ya funciona, el problema era ese archivo.
Para regenerarlo, ve al Back Office de PrestaShop > Parámetros avanzados > Rendimiento y pulsa "Vaciar la caché". PrestaShop creará un .htaccess nuevo.

[TIP]
Si el error persiste, revisa los permisos de las carpetas. Deben ser 755 y los archivos 644. En cPanel, selecciona todo y usa la opción "Cambiar permisos" en la barra superior.

2. Errores de conexión a la base de datos en cPanel

¿Ves un mensaje que dice "Error al conectarse a la base de datos"? Esto ocurre tras mover la tienda o cambiar la contraseña de la BD.

Solución:

Ve a Bases de datos MySQL en cPanel.
Verifica que el usuario de la BD tiene TODOS LOS PRIVILEGIOS sobre la base de datos.
Ahora, edita el archivo parameters.php que está en public_html/config/.
Busca las líneas database_host, database_name, database_user y database_password.
Asegúrate de que coinciden exactamente con los datos de tu cPanel. El host suele ser localhost, pero a veces es 127.0.0.1 o un servidor remoto como mysql.tudominio.com.

[WARNING]
Edita este archivo con el editor de texto de cPanel, nunca con un procesador de texto que pueda añadir caracteres extraños.

Problemas PrestaShop en Plesk

Plesk tiene una interfaz más "moderna", pero los errores suelen ser similares. Aquí la clave está en la gestión de dominios y subdominios.

3. Pantalla blanca o "Error 503" en Plesk

Este es el clásico problema PrestaShop Plesk. Sucede a menudo porque PHP se ejecuta como FastCGI o FPM y el archivo settings.inc.php no se puede escribir.

Solución:

Entra en Plesk y ve a Sitios web y dominios.
Selecciona tu dominio y haz clic en Hosting y DNS.
Busca la sección Configuración de PHP. Cambia el modo de ejecución de FastCGI a FPM (o viceversa). Aplica los cambios.
Si sigue fallando, ve a Archivos y navega hasta /httpdocs/config/.
Busca settings.inc.php. Haz clic derecho y selecciona Cambiar permisos. Pon 644 y guarda.

4. El error "No se puede escribir en el directorio de caché" en Plesk

Este es uno de los errores comunes en PrestaShop cuando hay problemas de propietario de archivos. En Plesk, el usuario del sistema es diferente al de cPanel.

Solución:

En Plesk, ve a Sitios web y dominios > Acceso al servidor Web.
Conéctate por SSH (si tienes acceso) o usa el Administrador de archivos de Plesk.
Necesitas cambiar el propietario de la carpeta var/cache al usuario del sistema. Si no puedes por SSH, usa el botón Cambiar propietario en el administrador de archivos.
Selecciona la carpeta cache y dentro las subcarpetas dev y prod. Bórralas. PrestaShop las recreará automáticamente con los permisos correctos.

[INFO]
Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106. La lógica es similar a Plesk, pero la estructura de carpetas suele estar en /home/usuario/web/tudominio/public_html. Los errores de caché se resuelven borrando la carpeta var/cache de la misma manera.

Errores comunes PrestaShop independientes del panel

Aquí tienes una colección de fallos que verás tanto en cPanel como en Plesk y cómo solucionarlos.

5. Error de compatibilidad de versión de PHP

PrestaShop es exigente con la versión de PHP. Si actualizas el PHP en tu panel y tu tienda es antigua, verás un error de "Clase no encontrada" o un montón de warnings.

Solución:

En cPanel: busca Seleccionar versión de PHP y prueba con una versión anterior (ej. 7.4 si tenías 8.0).
En Plesk: ve a Configuración de PHP y cambia el intérprete a una versión compatible (ej. 7.4).
Si tu tienda es muy antigua (1.6 o menor), necesitarás PHP 5.6 o 7.0, aunque te recomiendo actualizar la tienda.

6. El clásico "Error 429: Too Many Requests"

Esto ocurre cuando PrestaShop intenta conectarse a los servidores de Addons o a servicios externos y el hosting bloquea la conexión.

Solución:

Ve a Parámetros avanzados > Administración.
Desactiva la opción de "Comprobar actualizaciones automáticamente".
Ve a Parámetros avanzados > Rendimiento y desactiva la Caché de Smarty temporalmente para ver si el problema es un módulo.

7. Problemas con el archivo .htaccess en Plesk (Redirecciones infinitas)

A veces, Plesk tiene su propia configuración de redirección que choca con PrestaShop.

Solución:

Regenera el .htaccess desde el Back Office (Parámetros avanzados > Herramientas > Migrar).
Si no funciona, revisa que no haya reglas duplicadas en el archivo. Busca líneas que empiecen por RewriteRule y asegúrate de que solo hay un bloque de RewriteEngine On.

Preguntas Frecuentes (FAQ) sobre errores PrestaShop

¿Qué hago si mi tienda PrestaShop no carga después de moverla a otro hosting?

Es muy común. El error suele ser la base de datos. Edita config/parameters.php y verifica los datos. Además, borra la carpeta var/cache. En Plesk, acuérdate de cambiar los permisos de los archivos a 644 y carpetas a 755.

¿Cómo sé si el error es por un módulo o por el tema?

Activa el modo "Depuración" de PrestaShop. En config/defines.inc.php, cambia _PS_MODE_DEV_ a true. Esto mostrará el error exacto en pantalla. Si te dice el nombre del módulo, desactívalo desde la base de datos o renombra su carpeta en /modules/.

¿Por qué veo "Error al guardar las imágenes" en cPanel?

Es un problema PrestaShop Plesk y cPanel. Generalmente es por permisos. La carpeta img necesita permisos de escritura. En cPanel, haz clic derecho en la carpeta img y dale permisos 755. Si usas Syspanel (puerto 2106), el proceso es idéntico al de Plesk: cambiar el propietario de la carpeta a www-data.

¿El error de "sesión caducada" en el Back Office es grave?

No, pero es molesto. Ocurre por la configuración de cookies. Ve a Parámetros avanzados > Administración y en "Cookies" prueba a cambiar la opción de "Usar diferentes cookies por dominio" o revisa que la URL de tu tienda en Parámetros generales sea correcta (sin www si no lo usas).

Consejos finales para evitar futuros errores

Mantén todo actualizado: PrestaShop, módulos y temas. Las actualizaciones corrigen bugs que causan errores comunes.
Revisa los logs: En cPanel es errores.log en la raíz. En Plesk, en Logs dentro de tu dominio. Ahí verás el error exacto (PHP, MySQL, etc.).
Usa la caché con cabeza: La caché de Smarty acelera, pero si modificas archivos de plantilla, olvídala. Vacíala siempre tras cambios.

[INFO]
Si tu hosting es de tipo administrado (como Syspanel, puerto 2106), muchas veces el soporte técnico puede arreglar estos errores por ti si les pasas el log de errores. No dudes en abrir un ticket.

Conclusión

Hemos visto que los errores PrestaShop cPanel y los problemas PrestaShop Plesk tienen soluciones mecánicas y repetitivas: permisos, caché y configuración de PHP. Con esta guía, ya tienes un mapa para enfrentarte a ellos.

La próxima vez que veas una pantalla en blanco, respira hondo. Recuerda: primero el backup, luego vaciar la caché (var/cache), después revisar los permisos y, por último, el archivo parameters.php. En el 90% de los casos, el problema se resuelve en menos de 10 minutos.

Si el error persiste, no dudes en buscar el código exacto del error en los logs del servidor. Esa pista te llevará directamente a la solución. ¡Mucha suerte con tu tienda!