Errores comunes PrestaShop: Soluciones para cPanel, Plesk, DirectAdmin

¡Hola! Soy tu técnico de soporte amigable. Si estás aquí es porque tu tienda PrestaShop está dando algún que otro dolor de cabeza. No te preocupes, es más común de lo que crees. Hoy vamos a desglosar los errores PrestaShop comunes y, lo más importante, cómo solucionar problemas PrestaShop en los paneles de control más populares: cPanel, Plesk y DirectAdmin.

Voy a explicarte todo paso a paso, como si estuviéramos al teléfono. Al final de este artículo, te sentirás con el poder de diagnosticar y arreglar la mayoría de los fallos tú mismo. ¡Empezamos!

1. El temido "Error 500" o "Página Blanca"

Este es, sin duda, uno de los errores PrestaShop comunes más frustrantes. La pantalla se queda en blanco o muestra un escueto "Error 500". La causa suele ser un límite de memoria de PHP (memory_limit) demasiado bajo, un plugin (módulo) conflictivo o un tema mal configurado.

¿Cómo solucionarlo en cPanel?

cPanel es muy amigable para esto. Sigue estos pasos:

Entra a cPanel y busca la sección "Software".
Haz clic en "Select PHP Version" o "MultiPHP Manager" (depende de la versión).
Verás una pestaña que dice "Options" o "Switch to PHP Options". Haz clic ahí.
Busca la directiva memory_limit. El valor recomendado para PrestaShop es 256M o incluso 512M si tienes muchos productos.
Cambia el valor y haz clic en "Apply".
BONUS: Aprovecha y revisa también max_execution_time (ponlo en 120) y upload_max_filesize (ponlo en 64M).

[TIP] Si no ves la opción "Select PHP Version", contacta con tu hosting. A veces tienen desactivada esta función para compartir.

¿Cómo solucionarlo en Plesk?

En Plesk el proceso es igual de sencillo:

Ve a "Websites & Domains" y selecciona tu dominio.
Busca la sección "PHP Settings" (normalmente en la parte derecha o en el menú de herramientas).
En la ventana que se abre, localiza memory_limit.
Cámbialo a 256M o 512M.
Haz clic en "OK" para guardar.

¿Cómo solucionarlo en DirectAdmin?

En DirectAdmin es un poco más manual, pero fácil:

Ve a "Account Manager" > "Custom HTTPD Configs" o busca directamente "PHP Settings".
Si tienes la opción "PHP Selector", úsala. Busca memory_limit y ajústalo.
Si no tienes selector, tendrás que editar el archivo php.ini local. Puedes hacerlo desde "File Manager".
Busca el archivo php.ini en la raíz de tu web (si no existe, créalo).
Añade o modifica la línea: memory_limit = 256M.
Guarda el archivo.

[WARNING] Si el error persiste después de aumentar la memoria, desactiva todos los módulos no esenciales desde el panel de administración de PrestaShop (Módulos > Módulos y Servicios > Ver módulos > Desactivar). Luego reactívalos uno a uno para encontrar al culpable.

2. El "Error de conexión a la base de datos"

Este es otro clásico. Verás un mensaje como "Cannot connect to the database" o "Error de conexión a la base de datos". Generalmente, la culpa es de un cambio de contraseña de la base de datos, un servidor MySQL caído o un archivo de configuración corrupto.

Solución paso a paso (válido para cPanel, Plesk y DirectAdmin)

Verifica que el servidor MySQL está funcionando. En tu panel de control, busca "MySQL Databases" o "Database Manager". Si ves un mensaje de error al entrar, el servidor está caído. Contacta a tu soporte técnico.

Revisa el archivo app/config/parameters.php. Este archivo contiene los datos de conexión. Debe verse así:

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

Si cambiaste la contraseña de la base de datos desde el panel, ¡también debes actualizarla aquí! Edita el archivo con el File Manager y cambia la línea 'database_password' => 'tu_nueva_contraseña'.
Guarda los cambios y recarga tu tienda.

[INFO] Si usas Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso es 2106. La ruta al archivo parameters.php es la misma: app/config/parameters.php.

3. El error "No se puede cargar el módulo" o "Clase no encontrada"

Este error aparece cuando instalas un módulo o tema y PrestaShop no lo reconoce. Es un error de permisos de archivos o de caché de clases.

Solución para cPanel

Corrige los permisos de archivos. En cPanel, ve a "File Manager".
Selecciona la carpeta raíz de tu tienda (la que tiene las carpetas admin, modules, themes, etc.).
Haz clic derecho y elige "Change Permissions".
Marca "Apply to subdirectories and files" y pon permisos 755 para carpetas y 644 para archivos.
Haz clic en "OK".
Limpia la caché de PrestaShop. Ve a tu panel de administración: "Parámetros avanzados" > "Rendimiento" > "Limpiar caché".

Solución para Plesk

En Plesk, ve a "File Manager" desde tu dominio.
Selecciona la raíz y haz clic en "Change Permissions" en la barra de herramientas.
Marca "Apply to subdirectories" y "Apply to files".
Establece 755 para directorios y 644 para archivos.
Guarda.
Limpia la caché de PrestaShop desde el panel de administración.

Solución para DirectAdmin

En DirectAdmin, ve a "File Manager".
Selecciona la carpeta raíz y haz clic en "Change Permissions".
Marca "Recursive" (aplica a subcarpetas y archivos).
Pon 755 para directorios y 644 para archivos.
Guarda.
Limpia la caché de PrestaShop.

[WARNING] No pongas permisos 777 a toda la carpeta. Es un agujero de seguridad. Úsalo solo temporalmente y si sabes lo que haces.

4. El error "La página no se encuentra" (404) en categorías o productos

Esto suele pasar después de cambiar la URL amigable (URL rewriting) o al mover la tienda de servidor. PrestaShop no encuentra las rutas.

Solución (para todos los paneles)

Reconstruye el índice de URL. Ve a tu panel de administración de PrestaShop.
"Parámetros avanzados" > "Rendimiento".
Busca la sección "Reconstruir índice de URL" y haz clic en "Reconstruir".
Limpia la caché de URL. En la misma sección, busca "Limpieza de caché" y haz clic en "Limpiar caché".
Verifica el archivo .htaccess (solo si usas Apache). Si el archivo no existe o está corrupto, puedes regenerarlo desde "Parámetros avanzados" > "Herramientas" > "Generar .htaccess".
Si usas Nginx, asegúrate de que las reglas de reescritura de URL están configuradas en tu panel de control. En cPanel, suele estar en "Apache Handlers" o "Nginx Manager". En Plesk, en "Hosting Settings" > "Proxy mode". En DirectAdmin, en "Custom HTTPD Configs".

[TIP] Después de regenerar el .htaccess, espera 5 minutos y luego limpia la caché de tu navegador.

5. El error "No se pueden subir imágenes" o "Error al cargar imagen"

Este es otro de los errores PrestaShop comunes que más quejas genera. La causa suele ser un límite de tamaño de archivo (upload_max_filesize) muy bajo o un error de permisos en la carpeta img.

Solución para cPanel

Aumenta el límite de subida. Sigue los pasos del punto 1 (Error 500) pero busca la directiva upload_max_filesize y cámbiala a 64M.
Verifica los permisos de la carpeta img. Ve al File Manager, busca la carpeta img dentro de tu tienda. Haz clic derecho > "Change Permissions". Pon 755 y marca "Apply to subdirectories and files".

Solución para Plesk

Aumenta el límite. Ve a "PHP Settings" de tu dominio, busca upload_max_filesize y ponlo a 64M.
Permisos. Ve al File Manager, busca la carpeta img, cambia permisos a 755 de forma recursiva.

Solución para DirectAdmin

Aumenta el límite. Usa el "PHP Selector" o edita el php.ini local.
Permisos. Ve al File Manager, busca la carpeta img, cambia permisos a 755 de forma recursiva.

[INFO] Si usas Syspanel (HestiaCP), recuerda que el puerto de acceso es el 2106. El proceso es idéntico: editar el php.ini local y luego corregir permisos.

6. El error "El carrito no se actualiza" o "No se añaden productos al carrito"

Esto es muy común y suele deberse a un problema de cookies o a un conflicto con el tema o un módulo de caché.

Solución paso a paso

Limpia las cookies de tu navegador para el dominio de tu tienda.
Desactiva la caché de PrestaShop temporalmente. Ve a "Parámetros avanzados" > "Rendimiento" y desactiva "Caché" y "Caché de Smarty".
Prueba con el tema por defecto (Classic). Si el error desaparece, el problema es de tu tema personalizado. Contacta al desarrollador.
Revisa los módulos de caché (por ejemplo, "Page Cache" o "Varnish"). Desactívalos uno a uno para ver si alguno está causando el conflicto.

7. Preguntas Frecuentes (FAQ)

P: ¿Por qué veo un error de "Tiempo de ejecución excedido"?
R: Aumenta max_execution_time a 120 o 180 segundos en la configuración de PHP de tu panel (cPanel, Plesk, DirectAdmin).

P: ¿Cómo sé qué versión de PHP necesita mi PrestaShop?
R: PrestaShop 1.7 y 8.x necesitan PHP 7.1 o superior (recomendado PHP 8.0 o 8.1). Puedes verificar y cambiar la versión en la sección "Select PHP Version" de tu panel.

P: Mi tienda se vuelve muy lenta, ¿qué hago?
R: Activa la caché de PrestaShop (Parámetros avanzados > Rendimiento), optimiza las imágenes (usa WebP), y considera contratar un hosting con más recursos. También revisa que no tengas módulos innecesarios activados.

P: ¿Cómo hago una copia de seguridad antes de tocar algo?
R: Usa la herramienta de copia de seguridad de tu panel. En cPanel es "Backup", en Plesk es "Backup Manager", en DirectAdmin es "Create/Restore Backups". ¡Nunca está de más!

P: ¿Qué hago si no puedo acceder al panel de administración de PrestaShop?
R: Si es un error de base de datos, revisa el punto 2. Si es un error de permisos, revisa el punto 3. Si es un error de memoria, revisa el punto 1. Si nada funciona, contacta a tu hosting.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Si te encuentras con un error que no está aquí, ¡no dudes en preguntar a tu comunidad o a tu proveedor de hosting! ¡Buena suerte con tu tienda!