Errores frecuentes PrestaShop en cPanel/Plesk | Soluciones

Errores Comunes en PrestaShop y Cómo Solucionarlos en el Panel

Gestionar una tienda online con PrestaShop puede ser una experiencia increíble, pero a veces te encuentras con pantallazos blancos, errores de conexión o problemas con los módulos. No te preocupes, es más común de lo que crees y la mayoría de estos problemas tienen solución sin necesidad de ser un experto en programación.

En esta guía, te explicaremos los errores PrestaShop más frecuentes y, paso a paso, cómo solucionar PrestaShop desde tu panel de control. Veremos soluciones tanto para PrestaShop cPanel como para PrestaShop Plesk, y mencionaremos alternativas como Syspanel. Todo explicado de forma clara y sencilla.

[INFO] Esta guía está pensada para usuarios que tienen acceso a su panel de hosting. Si no tienes claro qué panel usas, pregunta a tu proveedor de hosting o revisa el correo de bienvenida de tu cuenta.

1. El Error de la Pantalla Blanca (WSOD)

Este es, sin duda, el error más temido. Entras a tu tienda y solo ves una página en blanco. No te asustes, casi siempre es por un límite de memoria o un módulo conflictivo.

¿Por qué ocurre?

Límite de memoria PHP agotado: Tu tienda necesita más memoria de la que tiene asignada.
Módulo o tema defectuoso: Algún complemento que acabas de instalar o actualizar está dando problemas.
Error de PHP: Un error en el código del núcleo de PrestaShop.

Solución desde cPanel o Plesk

Paso 1: Aumentar el límite de memoria PHP

Esta es la solución más común y la primera que debes probar.

Accede a tu panel de control. Si usas PrestaShop cPanel, busca la sección "Software" o "Configuración de PHP". Si usas PrestaShop Plesk, ve a "Herramientas y configuración" > "Configuración de PHP".
Busca la opción memory_limit. Normalmente está en un menú desplegable o una casilla de texto.
Aumenta el valor. Cambia de 128M a 256M o incluso 512M. También puedes aumentar max_execution_time a 300 y upload_max_filesize a 64M.
Guarda los cambios y recarga tu tienda.

Paso 2: Deshabilitar módulos desde la base de datos

Si el paso anterior no funciona, el problema es un módulo. Para deshabilitarlos sin entrar al panel de administración:

Accede a phpMyAdmin. En cPanel, búscalo en "Bases de datos". En Plesk, está en "Herramientas y configuración" > "phpMyAdmin".
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_modules (o prestashop_modules si tu prefijo es diferente).
Haz clic en "Examinar" o "Browse".
Marca todos los módulos que no sean indispensables (como los de pago o envío).
Selecciona "Deshabilitar" en el menú desplegable de acciones (suele ser "Desactivar" o "Disable").
Confirma la acción. Vuelve a tu tienda y comprueba si funciona.

[TIP] Si después de esto tu tienda vuelve a la vida, el problema era uno de esos módulos. Actívalos uno por uno desde el panel de administración para encontrar al culpable.

2. Error de Conexión a la Base de Datos

Este error suele aparecer como "Error de conexión a la base de datos" o "Cannot connect to database". Es un problema crítico porque tu tienda no puede acceder a sus datos.

Posibles causas

Credenciales incorrectas: Cambiaste la contraseña de la base de datos o el usuario.
Servidor de base de datos caído: Es raro, pero puede pasar.
Archivo de configuración corrupto: El archivo app/config/parameters.php tiene datos erróneos.

Solución paso a paso

Verifica las credenciales en tu panel. En cPanel, ve a "Bases de datos MySQL". En Plesk, a "Bases de datos". Asegúrate de que el usuario y la base de datos existen y que la contraseña es correcta.
Revisa el archivo parameters.php. Conéctate por FTP (FileZilla, por ejemplo) o usa el "Administrador de archivos" de tu panel. Busca en la carpeta app/config/ el archivo parameters.php.
Edítalo con un editor de texto. Busca las líneas que empiezan por 'database_host', 'database_user', 'database_password' y 'database_name'. Asegúrate de que coinciden exactamente con los datos de tu panel de control.
Si cambiaste la contraseña, actualízala también en este archivo. Guarda los cambios y vuelve a intentar acceder a tu tienda.

[WARNING] Ten mucho cuidado al editar este archivo. Un solo carácter mal puesto puede dejar tu tienda inservible. Siempre haz una copia de seguridad antes de modificarlo.

3. Error "500 Internal Server Error"

Este error es genérico y puede deberse a muchas cosas. Las causas más habituales son:

Problemas con el archivo .htaccess: Se ha corrompido o tiene reglas incorrectas.
Permisos de archivos incorrectos: Algunos archivos o carpetas tienen permisos que no deberían.
Un script PHP con errores.

Soluciones desde el panel

Solución A: Regenerar el archivo .htaccess

Renombra el archivo .htaccess en la raíz de tu PrestaShop. Puedes llamarlo .htaccess_old para tener una copia de seguridad.
Accede al panel de administración de PrestaShop (si es que puedes). Ve a "Parámetros de la tienda" > "Tráfico y SEO" > "SEO y URLs".
Haz clic en "Guardar" sin cambiar nada. Esto regenerará el archivo .htaccess automáticamente.
Si no puedes acceder al panel, crea un archivo .htaccess nuevo desde tu panel de control o FTP con el siguiente contenido básico:
```
<IfModule mod_rewrite.c>
RewriteEngine On
</IfModule>
```
Luego, intenta regenerarlo desde el panel cuando puedas.

Solución B: Revisar los permisos de archivos

Usa el "Administrador de archivos" de tu panel (cPanel, Plesk o Syspanel).
Ve a la carpeta raíz de tu PrestaShop.
Selecciona todas las carpetas (como admin, modules, themes, etc.) y haz clic en "Cambiar permisos".
Establece los permisos de las carpetas en 755 (o 0755).
Selecciona todos los archivos (los que no sean carpetas) y establece los permisos en 644 (o 0644).
Aplica los cambios. Esto suele solucionar muchos errores 500.

[INFO] Si tu panel es Syspanel, el puerto de acceso es el 2106 (ejemplo: tudominio.com:2106). Dentro, busca "Administrador de archivos" o "File Manager" para hacer estos cambios.

4. Errores al Subir Módulos o Temas

¿Has intentado instalar un nuevo módulo y te da un error de "archivo demasiado grande" o "no se puede cargar el archivo"?

Causas comunes

Límite de subida de PHP muy bajo.
El archivo está dañado o no es compatible con tu versión de PrestaShop.
Falta de espacio en el servidor.

Cómo solucionarlo

Aumenta los límites de PHP como vimos en el error de pantalla blanca. Busca upload_max_filesize y post_max_size y ponlos a 64M o 128M.
Verifica el espacio en disco. En cPanel, ve a "Estadísticas" o "Uso de disco". En Plesk, está en "Herramientas y configuración" > "Uso de disco". Si está casi lleno, libera espacio o contacta con tu hosting.
Sube el módulo manualmente. A veces el instalador web falla. Descarga el módulo, descomprímelo en tu ordenador y súbelo por FTP a la carpeta modules de tu PrestaShop. Luego, desde el panel de administración, ve a "Módulos" y búscalo en la lista para instalarlo.

5. El Panel de Administración no Carga Bien

A veces la tienda funciona, pero el back-office (el panel de administración) se ve raro, con estilos rotos o no carga del todo.

Posibles causas

Caché del navegador o de PrestaShop.
Problemas con la URL de la tienda en la configuración.
JavaScript bloqueado por algún módulo.

Soluciones rápidas

Limpia la caché de tu navegador (Ctrl + F5 o Cmd + Shift + R).
Limpia la caché de PrestaShop desde el panel. Si puedes acceder, ve a "Parámetros avanzados" > "Rendimiento" y haz clic en "Limpiar caché". Si no puedes, hazlo desde la base de datos: en phpMyAdmin, busca la tabla ps_cache y vacíala (truncar).
Regenera la URL de la tienda. Ve a "Parámetros de la tienda" > "Tráfico y SEO" > "SEO y URLs". Asegúrate de que la URL de tu tienda es correcta y guarda.
Desactiva el modo de depuración si lo tienes activado. En el archivo config/defines.inc.php, busca _PS_MODE_DEV_ y ponlo en false.

6. Errores de Envío de Correos (Pedidos, Notificaciones)

¿Tu tienda no envía correos de confirmación de pedido o de registro?

Diagnóstico y solución

Revisa la configuración de correo en PrestaShop. Ve a "Parámetros avanzados" > "Correo electrónico". Prueba a enviar un correo de prueba.
Cambia el método de envío. Si tienes "Usar la función mail() de PHP" y no funciona, cámbialo a "Usar mi propio servidor SMTP" y configura los datos de tu proveedor de correo (suelen ser mail.tudominio.com, puerto 465 o 587, con autenticación).
Verifica que el puerto SMTP no está bloqueado por tu hosting. Algunos planes bloquean puertos de correo. Consulta con tu soporte.
Comprueba la bandeja de spam. A veces los correos llegan allí.

Preguntas Frecuentes (FAQ)

P: ¿Qué hago si no recuerdo mi contraseña de la base de datos?
R: En cPanel, ve a "Bases de datos MySQL" y busca la opción "Cambiar contraseña". En Plesk, ve a "Bases de datos", selecciona la base de datos y haz clic en "Cambiar contraseña". Luego, actualiza el archivo parameters.php como vimos antes.

P: ¿Cómo sé qué versión de PHP usa mi PrestaShop?
R: En cPanel, ve a "Configuración de PHP" y verás la versión seleccionada. En Plesk, ve a "Herramientas y configuración" > "Configuración de PHP". PrestaShop 1.7 necesita PHP 7.1 o superior, y PrestaShop 8 necesita PHP 8.0 o superior.

P: Mi tienda está muy lenta, ¿qué puedo hacer?
R: Activa la caché en "Parámetros avanzados" > "Rendimiento". También puedes optimizar las imágenes y desactivar módulos que no uses. Si el problema persiste, considera aumentar los recursos de tu plan de hosting.

P: ¿Puedo usar Syspanel para gestionar mi PrestaShop?
R: Sí, totalmente. Syspanel (antes conocido como HestiaCP) es un panel de control muy útil. Recuerda que el puerto de acceso es el 2106. En él encontrarás herramientas como el Administrador de archivos, phpMyAdmin y configuraciones de PHP, que te servirán para aplicar todas las soluciones de esta guía.

P: He probado todo y nada funciona, ¿qué hago?
R: No te desesperes. Lo mejor es contactar con el soporte técnico de tu hosting. Ellos tienen acceso directo a los logs del servidor y pueden ver exactamente qué está fallando. Diles el error que ves y los pasos que ya has intentado.

[WARNING] Siempre, siempre, haz una copia de seguridad de tu tienda (archivos y base de datos) antes de hacer cambios importantes. Esto te salvará de muchos dolores de cabeza. Puedes hacerlo desde tu panel de control (cPanel, Plesk o Syspanel) con herramientas como "Backup" o "Copias de seguridad".

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que la mayoría de los errores PrestaShop tienen solución y, con un poco de paciencia y siguiendo estos pasos, podrás tener tu tienda funcionando de nuevo en poco tiempo. ¡Mucho éxito con tu negocio online!