Solucionar errores en PrestaShop: Guía desde cPanel y Plesk

¿Tu tienda PrestaShop se ha quedado congelada, muestra un error en la pantalla de inicio o no te deja acceder al panel de administración? No te preocupes. La mayoría de los errores más comunes en PrestaShop se pueden solucionar directamente desde el panel de control de tu hosting, ya sea cPanel, Plesk o Syspanel (el nombre comercial de HestiaCP, accesible por el puerto 2106).

En esta guía extensa, paso a paso, te voy a enseñar a diagnosticar y resolver los problemas más frecuentes que afectan a las tiendas PrestaShop, utilizando las herramientas que ya tienes a tu disposición. No necesitas ser un desarrollador para solucionarlos.

¿Por qué aparecen los errores en PrestaShop?

Antes de ponernos manos a la obra, es importante entender que muchos errores PrestaShop no son culpa de la plataforma en sí, sino de su entorno. Factores como la configuración del servidor, los permisos de archivos, la memoria PHP o una base de datos sobrecargada son los principales desencadenantes.

El panel de control (cPanel, Plesk o Syspanel) es la llave maestra para ajustar estos parámetros. Vamos a ver los errores más habituales y cómo atacarlos.

Error 500 (Internal Server Error): El más común de los errores PrestaShop

Este error es un "cajón de sastre". Significa que algo falló en el servidor, pero no te da detalles. La solución pasa por dos frentes: aumentar la memoria PHP y revisar los archivos .htaccess.

Aumentar el límite de memoria PHP desde el panel de control

El límite de memoria PHP por defecto suele ser muy bajo (32MB o 64MB). PrestaShop necesita al menos 128MB, y para tiendas con muchos módulos, 256MB o más.

Si usas cPanel:

Accede a tu cPanel.
Busca la sección Software y haz clic en Seleccionar versión de PHP (o MultiPHP Manager).
En la nueva ventana, busca la opción Opciones o Switch to PHP Options.
Localiza el parámetro memory_limit. Cámbialo a 256M o 512M.
Guarda los cambios. El servidor se reiniciará automáticamente.

Si usas Plesk:

Ve a tu panel de Plesk.
En el menú de la izquierda, haz clic en Configuración de PHP (dentro de la sección de tu dominio).
En la pestaña Configuración de PHP, busca memory_limit.
Ajusta el valor a 256M.
Haz clic en Aceptar.

Si usas Syspanel (HestiaCP, puerto 2106):

Accede a tu Syspanel a través de tudominio.com:2106.
Ve a Web > Configuración avanzada (o PHP-FPM).
Busca la opción memory_limit y cámbiala a 256M.
Guarda y el servicio se recargará.

[TIP] Si después de cambiar la memoria el error persiste, prueba a desactivar todos los módulos de PrestaShop desde el administrador (si puedes acceder) o renombrando la carpeta /modules a /modules_old vía FTP o el gestor de archivos del panel. Luego ve activándolos uno a uno.

Restaurar el archivo .htaccess

Un archivo .htaccess corrupto es otra causa frecuente del Error 500. Lo mejor es regenerarlo.

Desde tu panel de control (cPanel, Plesk o Syspanel), usa el Administrador de Archivos o conéctate por FTP.
Navega a la carpeta raíz de tu tienda PrestaShop.
Busca el archivo .htaccess. Si no lo ves, activa la opción Mostrar archivos ocultos.
Renómbralo a .htaccess_old (esto lo desactivará).
Ahora, accede a tu tienda por el navegador. Si el error desaparece, el problema era el .htaccess.
Para regenerarlo, ve al panel de administración de PrestaShop: Parámetros de la tienda > Tráfico y SEO > SEO & URLs.
Desplázate hasta abajo y haz clic en Guardar (sin cambiar nada). Esto regenerará el archivo.

Error de conexión a la base de datos: "Cannot connect to database"

Este error suele aparecer tras una migración, al cambiar de hosting o por un fallo en los datos de acceso.

Verificar y corregir los datos de conexión desde el panel

La configuración de la base de datos se guarda en el archivo app/config/parameters.php.

Desde el Administrador de Archivos de tu panel (cPanel, Plesk o Syspanel), navega a la carpeta raíz de PrestaShop.
Abre la ruta app/config/.
Busca el archivo parameters.php y ábrelo con el editor de texto del panel.

Busca estas líneas:

'database_host' => 'localhost',
'database_port' => '3306',
'database_name' => 'tu_nombre_bd',
'database_user' => 'tu_usuario_bd',
'database_password' => 'tu_contraseña_bd',

Comprueba que los datos coincidan exactamente con los que te proporcionó tu hosting. Si no estás seguro, puedes crear una nueva base de datos y usuario desde tu panel de control:
- En cPanel: Usa el asistente MySQL Databases.
- En Plesk: Ve a Bases de datos y añade una nueva.
- En Syspanel: Ve a Bases de datos > Añadir base de datos.
Si los datos son incorrectos, corrígelos y guarda el archivo.

[WARNING] Si cambias la base de datos a una nueva, perderás todos los productos y pedidos anteriores a menos que importes un backup de la base de datos antigua.

Probar la conexión manualmente

Otra forma de verificar es conectarte a la base de datos desde el panel de control:

En cPanel, busca phpMyAdmin. En Plesk, es phpMyAdmin dentro de la sección de la base de datos. En Syspanel, está en Bases de datos > phpMyAdmin.
Intenta iniciar sesión con el usuario y contraseña que tienes en el parameters.php.
Si no puedes, el problema son las credenciales. Crea un nuevo usuario para la base de datos desde el panel de control y asígnale todos los privilegios. Luego, actualiza el parameters.php.

Pantalla en blanco (White Screen of Death) al activar un módulo o tema

Este es otro clásico. La pantalla se queda completamente en blanco, sin ningún mensaje de error.

Solución rápida: Desactivar el modo de desarrollo y forzar logs

PrestaShop tiene un modo de desarrollo que, al activarlo, muestra los errores PHP en pantalla en lugar de la pantalla en blanco.

Abre el archivo config/defines.inc.php desde el Administrador de Archivos.
Busca la línea:
```
define('_PS_MODE_DEV_', false);
```
Cámbiala a:
```
define('_PS_MODE_DEV_', true);
```
Guarda el archivo y recarga tu tienda. Ahora verás un mensaje de error PHP que te indicará exactamente qué archivo y línea están causando el problema (por ejemplo, un error de sintaxis en un archivo de módulo).
Una vez solucionado, vuelve a poner false para que los clientes no vean los errores.

Desactivar el módulo problemático desde la base de datos

Si no puedes ni siquiera acceder al administrador, puedes desactivar el módulo directamente desde la base de datos usando phpMyAdmin.

Accede a phpMyAdmin desde tu panel de control.
Selecciona la base de datos de tu PrestaShop.
Busca la tabla ps_module (el prefijo ps_ puede variar).
Haz clic en Examinar (o Browse).
Localiza el módulo que crees que está causando el problema (por el nombre).
Haz clic en Editar (el lápiz) en la fila de ese módulo.
Cambia el valor de la columna active de 1 a 0.
Guarda los cambios. El módulo quedará desactivado y podrás acceder a tu panel de administración.

[INFO] Si no sabes qué módulo es, desactiva todos cambiando active a 0 para todos los módulos en la tabla ps_module. Luego, desde el administrador, los vas activando uno a uno.

Error de permisos de archivos y carpetas

PrestaShop necesita permisos específicos para escribir en ciertas carpetas (como cache, log, upload, img). Un error común es ver un mensaje que dice "No se puede escribir en la carpeta".

Corregir permisos desde el panel de control

La solución es dar los permisos correctos a las carpetas problemáticas.

Desde el Administrador de Archivos de tu panel, navega a la raíz de PrestaShop.
Selecciona las carpetas problemáticas (normalmente cache, log, upload, img, config, translations, modules).
Haz clic en Permisos o Change Permissions.
Establece los permisos a 755 para las carpetas y 644 para los archivos dentro de ellas.
Aplica a subdirectorios (recursivamente).
También puedes hacerlo vía FTP: selecciona la carpeta raíz, haz clic derecho y elige "Permisos de archivo". Pon 755 y marca "Recurrir en subcarpetas" y "Aplicar a todos los archivos y carpetas".

[TIP] Si usas Syspanel, el gestor de archivos también tiene una opción para cambiar permisos. Es el mismo procedimiento.

Error de compatibilidad de versión de PHP

PrestaShop 1.6, 1.7 y 8.x requieren versiones de PHP muy diferentes. Usar una versión incorrecta provoca errores de todo tipo.

Cambiar la versión de PHP desde el panel

En cPanel: Busca Seleccionar versión de PHP (o MultiPHP Manager). Selecciona tu dominio y elige la versión recomendada para tu PrestaShop (ej. PHP 7.4 para PS 1.7, PHP 8.0 o 8.1 para PS 8.x).
En Plesk: Ve a Configuración de PHP y en la pestaña General selecciona la versión de PHP que deseas.
En Syspanel: Ve a Web > Configuración avanzada y en el campo Versión PHP elige la adecuada.

[WARNING] Cambiar a una versión de PHP más moderna puede romper módulos antiguos. Siempre verifica la compatibilidad antes de hacer el cambio.

Preguntas Frecuentes (FAQ) sobre errores PrestaShop

P: ¿Puedo solucionar estos errores sin el panel de control?
R: Algunos sí, usando un cliente FTP, pero el panel de control (cPanel, Plesk, Syspanel) te da acceso directo a la configuración del servidor (memoria PHP, versiones, bases de datos) que es donde residen la mayoría de las soluciones. Es la herramienta más eficaz.

P: ¿Qué hago si después de todo el error persiste?
R: Revisa los logs de error del servidor. En cPanel están en Errores > Error Log. En Plesk, en Logs > Log de errores. En Syspanel, en Administración > Logs del sistema. El log te dará la línea exacta del error.

P: ¿Es seguro modificar archivos como parameters.php o .htaccess?
R: Sí, siempre que sepas lo que estás haciendo. Si no estás seguro, haz una copia de seguridad del archivo antes de editarlo (por ejemplo, renómbralo a .php.bak). Así, si algo sale mal, puedes restaurarlo.

P: Mi tienda se cae cuando hay mucho tráfico. ¿Qué puedo hacer?
R: Eso suele ser un problema de recursos del servidor. Desde tu panel de control, puedes aumentar la memoria PHP (como vimos) o, si tu plan lo permite, contratar más recursos (RAM, CPU). También puedes activar la caché de PrestaShop en Parámetros de la tienda > Rendimiento.

P: ¿Syspanel es lo mismo que HestiaCP?
R: Sí, exactamente. En este artículo lo llamamos Syspanel, y recuerda que siempre se accede a través del puerto 2106 (ejemplo: tudominio.com:2106).

Con estas herramientas y pasos, podrás resolver la mayoría de los errores PrestaShop que te encuentres. Recuerda que la clave está en el panel de control: es tu centro de mando para mantener tu tienda sana y funcionando. ¡Manos a la obra!