Problemas comunes de PrestaShop en cPanel y cómo solucionarlos

Si tienes una tienda online con PrestaShop y la gestionas a través de cPanel, es probable que en algún momento te encuentres con algún contratiempo técnico. No te preocupes, es completamente normal. La combinación de un potente CMS como PrestaShop con un panel de control tan versátil como cPanel ofrece muchas ventajas, pero también puede presentar algunos errores típicos. En esta guía extensa y práctica, vamos a desglosar los problemas más comunes que puedes enfrentar y, lo más importante, cómo solucionarlos paso a paso.

El objetivo es que, incluso sin ser un experto en Linux y SysAdmin, puedas diagnosticar y resolver estas incidencias por ti mismo. Al final, también encontrarás una sección de preguntas frecuentes (FAQ) para resolver dudas rápidas.

Errores típicos de instalación y configuración inicial

Cuando instalas PrestaShop por primera vez en tu hosting con cPanel, pueden surgir algunos problemas que impiden que la tienda funcione correctamente desde el principio. Vamos a ver los más habituales.

El instalador no avanza o da error de conexión a la base de datos

Uno de los errores más frustrantes es que el asistente de instalación de PrestaShop se quede atascado o muestre un mensaje como "No se puede conectar a la base de datos". Esto suele deberse a datos incorrectos o a permisos mal configurados.

Solución paso a paso:

Verifica los datos de acceso a la base de datos: Asegúrate de que el nombre de la base de datos, el usuario y la contraseña sean exactamente los que creaste en cPanel. Recuerda que en cPanel, el nombre de la base de datos y el usuario suelen tener un prefijo (por ejemplo, tuusuario_bd1 y tuusuario_user1).
Comprueba el host de la base de datos: El campo "Servidor de base de datos" casi siempre debe ser localhost. Si tu hosting usa un servidor remoto, cPanel te proporcionará la dirección exacta en la sección "Bases de datos MySQL".
Revisa los privilegios del usuario: En cPanel, dentro de "Bases de datos MySQL", asegúrate de que el usuario tenga TODOS LOS PRIVILEGIOS marcados (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Si no es así, asígnaselos.

[TIP] Si después de verificar todo sigue fallando, crea una nueva base de datos y un nuevo usuario desde cero en cPanel, y vuelve a intentar la instalación. A veces, un error de permisos heredado puede solucionarse así.

La página se ve en blanco (White Screen of Death) tras la instalación

Este es uno de los errores PrestaShop más temidos. Después de instalar, al acceder a tu dominio solo ves una pantalla en blanco. Generalmente es un problema de PHP o de memoria.

Solución paso a paso:

Aumenta el límite de memoria PHP: En cPanel, busca la sección "Seleccionar versión de PHP" (o "MultiPHP Manager"). Una vez dentro, haz clic en "Opciones" o "Switch to PHP Options". Busca la directiva memory_limit y cámbiala a un valor mínimo de 256M o incluso 512M. Guarda los cambios.
Habilita la visualización de errores: Temporalmente, para ver qué está fallando, edita el archivo config/defines.inc.php de tu instalación de PrestaShop. Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Esto mostrará el error en lugar de la pantalla en blanco.
Verifica la versión de PHP: PrestaShop 1.7 y 8.x requieren PHP 7.1 o superior, siendo recomendable PHP 8.0 o 8.1. En "Seleccionar versión de PHP" en cPanel, elige una versión compatible.

[WARNING] No olvides volver a poner _PS_MODE_DEV_ en false una vez hayas solucionado el problema, ya que tenerlo en true en un sitio en producción expone información sensible.

Problemas comunes de rendimiento y velocidad

Una tienda lenta ahuyenta a los clientes. Si tu PrestaShop va como un caracol, estos son los pasos para solucionarlo desde tu hosting en cPanel.

La tienda carga muy lento, especialmente el catálogo

La lentitud suele estar relacionada con la caché, la configuración de la base de datos o el servidor web.

Soluciones prácticas:

Activa la caché de PrestaShop: Ve al backoffice de tu tienda: Parámetros de la tienda > Rendimiento. Aquí puedes:
- Activar la caché: Elige "Sistema de archivos" o "Memcached" si tu hosting lo soporta.
- Combinar y comprimir archivos: Activa "Combinar archivos CSS" y "Combinar archivos JavaScript". También activa la compresión HTML.
Optimiza la base de datos: En cPanel, usa la herramienta "phpMyAdmin". Selecciona tu base de datos de PrestaShop y, en la pestaña "Operaciones", haz clic en "Optimizar tablas". Esto libera espacio y mejora las consultas.
Habilita la compresión Gzip: En cPanel, en la sección "Optimizar sitio web", puedes activar la compresión Gzip. Esto reduce el tamaño de los archivos que se envían al navegador.
Revisa el uso de módulos: Demasiados módulos activos, especialmente los que cargan scripts pesados, ralentizan la tienda. Desactiva los que no uses.

[INFO] Si tu hosting es muy básico (compartido), considera migrar a un plan VPS o a un hosting optimizado para PrestaShop. A veces, el límite de recursos del plan es el cuello de botella.

Error "500 Internal Server Error" al azar

Este es otro clásico. Puede aparecer al navegar por el catálogo o al acceder al backoffice. Las causas son variadas, pero la más común es un archivo .htaccess corrupto o un límite de recursos excedido.

Cómo solucionarlo:

Regenera el archivo .htaccess: Ve al backoffice de PrestaShop: Parámetros de la tienda > Tráfico y SEO > SEO y URLs. Sin cambiar nada, haz clic en "Guardar". Esto regenera el archivo .htaccess automáticamente.
Aumenta los límites de PHP: Como vimos antes, desde "MultiPHP Manager" en cPanel, aumenta max_execution_time a 120 segundos y max_input_vars a 5000. Guarda los cambios.
Revisa los logs de errores: En cPanel, ve a "Visor de errores" (dentro de "Métricas"). Allí verás la causa exacta del error 500. Busca líneas que contengan "PrestaShop" o "PHP Fatal error".

Problemas con el backoffice y módulos

A veces, el problema no está en la tienda pública, sino en el panel de administración.

No puedo acceder al backoffice (error de redirección o página en blanco)

Este problema suele deberse a una configuración incorrecta de las URLs amigables o a un problema con la sesión.

Pasos para solucionarlo:

Accede directamente: Prueba a acceder a tudominio.com/adminXXXXX/index.php (sustituye adminXXXXX por tu carpeta real de administración). A veces, la redirección automática falla.
Limpia la caché del navegador y las cookies: Parece obvio, pero a menudo soluciona problemas de sesión.
Revisa la configuración de la URL en la base de datos: Si no puedes acceder de ninguna manera, tendrás que usar phpMyAdmin. Busca la tabla ps_configuration y localiza las variables PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL. Asegúrate de que contengan tu dominio correcto (sin http:// o https://).
Verifica los permisos de la carpeta de administración: En el administrador de archivos de cPanel, la carpeta de administración (ej. /admin12345/) debe tener permisos 755 o 750. Si tiene 777, cámbialos.

Un módulo no se instala o da error al activarlo

Muchos módulos de PrestaShop requieren permisos de escritura en ciertas carpetas o extensiones de PHP específicas.

Qué hacer:

Comprueba los permisos de carpetas: Las carpetas /modules, /themes, /override, /upload, /download y /img deben tener permisos 755. Si algún módulo necesita escribir en ellas, el error aparecerá.
Verifica las extensiones PHP necesarias: El módulo puede requerir extensiones como curl, gd, mbstring, zip, etc. En cPanel, en "Seleccionar versión de PHP", verás una lista de extensiones. Asegúrate de que las necesarias estén marcadas.
Aumenta el límite de subida de archivos: Si el módulo es un archivo ZIP grande, es posible que el límite de subida de PHP sea muy bajo. En "MultiPHP Manager", busca upload_max_filesize y post_max_size y ajústalos a un valor mayor (ej. 64M).

[WARNING] Desconfía de los módulos gratuitos de fuentes no oficiales. Suelen ser la causa de vulnerabilidades de seguridad y errores difíciles de rastrear. Instala siempre módulos del marketplace oficial de PrestaShop o de desarrolladores de confianza.

Problemas de seguridad y SSL

La seguridad es crítica en una tienda online. Un error común es que el candado de seguridad no aparezca.

El sitio no carga con HTTPS, o hay contenido mixto (advertencia de seguridad)

Esto ocurre cuando el certificado SSL está mal configurado o cuando hay recursos (imágenes, CSS) que se cargan desde URLs con HTTP.

Solución:

Fuerza el HTTPS desde PrestaShop: En el backoffice: Parámetros de la tienda > Tráfico y SEO > SEO y URLs. Activa la opción "Forzar URL canónica" y, sobre todo, activa "Redirigir a HTTPS". Guarda los cambios.
Configura el SSL en cPanel: Ve a "SSL/TLS" y luego a "Gestionar certificados SSL". Asegúrate de que tu dominio tenga un certificado válido instalado. Si usas un certificado gratuito de AutoSSL, cPanel lo gestiona automáticamente.
Corrige el contenido mixto: Usa un plugin o una herramienta online para escanear tu tienda en busca de contenido HTTP. Luego, en el backoffice, ve a Parámetros de la tienda > Rendimiento y activa la opción "Forzar SSL en todas las páginas". También puedes usar la herramienta "Buscar y reemplazar" en phpMyAdmin para cambiar http://tudominio.com por https://tudominio.com en las tablas de contenido.

[TIP] Si después de todo esto el problema persiste, revisa que tu tema (plantilla) no tenga enlaces HTTP duros en su código. A veces, los temas antiguos no están preparados para HTTPS.

Preguntas Frecuentes (FAQ) sobre PrestaShop en cPanel

Aquí respondemos las dudas más habituales que suelen tener los usuarios.

¿Por qué mi PrestaShop se cae cuando recibo mucho tráfico?

Lo más probable es que tu plan de hosting no tenga suficientes recursos (CPU y RAM) para soportar el pico de visitas. Soluciones: 1) Optimiza la caché de PrestaShop. 2) Usa un CDN (Content Delivery Network). 3) Contrata un plan de hosting superior (VPS o dedicado) que ofrezca más recursos.

¿Cómo puedo hacer una copia de seguridad de mi tienda desde cPanel?

Es muy sencillo. En cPanel, usa la herramienta "Copias de seguridad". Selecciona "Descargar una copia de seguridad completa de la cuenta". Esto descargará un archivo que contiene tanto los archivos de tu sitio como las bases de datos. Es recomendable hacerlo al menos una vez por semana.

¿Qué hago si olvido mi contraseña del backoffice de PrestaShop?

No necesitas cPanel para esto. En la página de inicio de sesión de tu backoffice, haz clic en "¿Olvidó su contraseña?". Introduce tu correo electrónico y recibirás un enlace para restablecerla. Si no recibes el correo, verifica que la función de envío de correo de tu hosting funcione correctamente (puedes probar con un script de prueba).

¿Puedo migrar mi PrestaShop a otro hosting con cPanel? ¿Cómo?

Sí, es posible. El proceso general es: 1) Haz una copia de seguridad completa de tu tienda actual (archivos y base de datos). 2) En el nuevo cPanel, crea una base de datos y un usuario. 3) Sube los archivos de tu tienda a la carpeta public_html del nuevo hosting. 4) Importa la base de datos usando phpMyAdmin. 5) Edita el archivo app/config/parameters.php para actualizar los datos de conexión a la nueva base de datos. 6) Cambia las URLs en la base de datos (tabla ps_configuration) a tu nuevo dominio.

¿Qué es Syspanel y cómo se relaciona con cPanel?

Syspanel (término que usamos para referirnos a HestiaCP) es otro panel de control para servidores, similar a cPanel pero más ligero. Si tu hosting usa Syspanel, el puerto de acceso es el 2106 (ej. tudominio.com:2106). Aunque la interfaz es diferente, los conceptos para solucionar errores PrestaShop son los mismos: gestionar bases de datos, archivos y versiones de PHP. Si tu proveedor te da acceso a Syspanel, las soluciones de esta guía son igualmente aplicables, solo que los nombres de las secciones pueden variar ligeramente.

Con esta guía extensa, esperamos que puedas afrontar y resolver la mayoría de los problemas que surjan con tu PrestaShop en cPanel. Recuerda que la paciencia y la observación son tus mejores aliadas. ¡Buena suerte con tu tienda online!