Errores comunes de PrestaShop y cómo solucionarlos (cPanel, Plesk, DirectAdmin)

Errores PrestaShop más comunes y cómo resolverlos en cPanel y Plesk

Cuando tu tienda online construida con PrestaShop empieza a dar problemas, la frustración puede ser enorme. Un error de base de datos, una pantalla en blanco o un problema con los permisos de archivos pueden detener tus ventas por completo.

La buena noticia es que la mayoría de los errores PrestaShop tienen una solución clara y paso a paso, tanto si tu hosting usa cPanel como Plesk. En esta guía extensa, te explicaré cómo diagnosticar y arreglar los fallos más habituales, con un lenguaje sencillo para que puedas hacerlo tú mismo, sin necesidad de ser un experto en programación.

Vamos a ello. Respira hondo, porque después de leer este artículo, serás capaz de enfrentarte a los famosos "Error 500", "Error de conexión a la base de datos" o "La página no carga" con total confianza.

1. El temido "Error 500" o pantalla en blanco

Este es, sin duda, el error PrestaShop más común. Puede aparecer de repente tras actualizar un módulo, cambiar de tema o simplemente al mover la tienda a un servidor nuevo. La pantalla se queda en blanco o muestra un mensaje genérico de "Error interno del servidor".

¿Por qué ocurre?

Las causas principales suelen ser tres: un archivo .htaccess corrupto, falta de memoria PHP o un módulo/theme incompatible.

Solución paso a paso en cPanel

Accede a tu panel de control de cPanel con tus credenciales.
Busca la sección "Administrador de archivos" y entra en la carpeta public_html (o la carpeta donde esté instalada tu tienda).
Localiza el archivo .htaccess. Si no lo ves, activa la opción "Mostrar archivos ocultos" (suele estar en la esquina superior derecha).
Descarga una copia de este archivo a tu ordenador como respaldo.
Ahora, elimina el archivo .htaccess del servidor.
Ve a tu tienda y recarga la página. Si el error desaparece, el problema era este archivo.
Para regenerarlo, entra en el Panel de administración de PrestaShop (tudominio.com/admin) y ve a Parámetros Avanzados > Rendimiento. Pulsa el botón "Vaciar la caché" y luego "Regenerar el .htaccess".

Solución paso a paso en Plesk

Entra en Plesk y ve a "Administrador de archivos" dentro de tu dominio.
Navega hasta la carpeta httpdocs (el equivalente a public_html).
Activa la vista de archivos ocultos y localiza el .htaccess.
Renómbralo a .htaccess.bak en lugar de borrarlo directamente. Esto es más seguro por si acaso.
Recarga tu tienda. Si funciona, regenera el archivo desde el back-office de PrestaShop como se explicó antes.

[WARNING]
Si tras borrar el .htaccess el error persiste, el problema no es ese. Restaura el archivo desde tu copia de seguridad y pasa al siguiente punto.

Aumentar la memoria PHP (solución para ambos paneles)

Muchas veces, el error 500 se debe a que PHP se queda sin memoria. Esto es muy común en tiendas con muchos módulos.

En cPanel, busca la herramienta "Select PHP Version" o "Administrador de PHP". En Plesk, ve a "Configuración de PHP" dentro de tu dominio.
Busca la opción memory_limit.
Cámbiala a un valor mayor, por ejemplo, 256M o 512M.
Guarda los cambios y recarga la tienda.

2. Error de conexión con la base de datos MySQL

Otro clásico. Verás un mensaje como "Error de conexión a la base de datos" o "Link to database cannot be established". Esto significa que PrestaShop no puede comunicarse con la base de datos donde guarda tus productos, pedidos y clientes.

¿Por qué ocurre?

Las causas más frecuentes son: los datos de acceso en el archivo de configuración son incorrectos, la base de datos está llena o el servidor MySQL está caído.

Solución: Verificar los datos de conexión

Tanto en cPanel como en Plesk, el archivo clave es parameters.php, ubicado en la carpeta config de tu instalación de PrestaShop.

Ve al Administrador de archivos de tu panel.
Navega a config/ y abre el archivo parameters.php con el editor de texto.
Busca estas líneas y verifica que los datos sean correctos:

'database_host' => 'localhost',
'database_name' => 'tu_usuario_basedatos',
'database_user' => 'tu_usuario_sql',
'database_password' => 'tu_contraseña_segura',

Si no estás seguro de cuáles son tus credenciales, puedes crearlas o verlas desde la sección "Bases de datos MySQL" en cPanel, o "Bases de datos" en Plesk.

[TIP]
Asegúrate de que el valor de database_host sea correcto. A veces, en hostings compartidos, no es localhost sino algo como mysql.tudominio.com. Pregunta a tu proveedor si no estás seguro.

¿Y si la base de datos está llena?

Entra en phpMyAdmin desde tu panel (cPanel o Plesk).
Selecciona tu base de datos de PrestaShop.
En la pestaña "Base de datos" o "SQL", ejecuta esta consulta para ver el tamaño:

SELECT table_schema AS "Database", ROUND(SUM(data_length + index_length) / 1024 / 1024, 2) AS "Size (MB)" FROM information_schema.TABLES GROUP BY table_schema;

Si está al 100%, tendrás que optimizar las tablas o eliminar registros antiguos (como carritos abandonados o logs) para liberar espacio.

3. El problema de los permisos de archivos

Los permisos incorrectos son una fuente inagotable de errores PrestaShop. Si los archivos tienen permisos demasiado restrictivos (por ejemplo, 644 cuando deberían ser 755), la tienda no podrá escribir archivos de caché, subir imágenes o modificar temas.

¿Cómo solucionarlo en cPanel?

Entra en el Administrador de archivos.
Selecciona todos los archivos y carpetas de tu instalación de PrestaShop (usa Ctrl+A dentro de la carpeta raíz).
Haz clic derecho y selecciona "Permisos".
Cambia los permisos de las carpetas a 755 y los de los archivos a 644.
Marca la casilla "Cambiar archivos y carpetas de forma recursiva" y confirma.

¿Cómo solucionarlo en Plesk?

Ve al Administrador de archivos.
Selecciona la carpeta raíz de tu dominio (httpdocs).
Haz clic en el botón "Permisos" en la barra superior.
Ajusta los permisos de forma similar: 755 para directorios y 644 para archivos, activando la recursividad.

[INFO]
Algunos módulos o temas requieren permisos más permisivos como 777 para funcionar. Si un módulo específico falla, consulta su documentación. Nunca dejes toda la tienda en 777 por seguridad.

4. Errores de caché y compilación de plantillas

A veces, después de hacer cambios en el diseño o instalar un módulo, la tienda sigue mostrando la versión anterior. Esto se debe a la caché de PrestaShop o a las plantillas compiladas.

Solución en ambos paneles (cPanel y Plesk)

La solución es la misma, ya que se hace desde el back-office:

Accede a tu Panel de Administración.
Ve a Parámetros Avanzados > Rendimiento.
En la sección "Caché", desactívala temporalmente o, mejor aún, pulsa el botón "Vaciar la caché".
En la sección "Plantillas", asegúrate de que la opción "Forzar la compilación" esté activada mientras pruebas. Luego, vuelve a desactivarla para un rendimiento óptimo.
Guarda los cambios y recarga la tienda.

Si el problema persiste, también puedes borrar manualmente el contenido de la carpeta var/cache (en PrestaShop 1.7+) o cache (en versiones antiguas) desde el Administrador de archivos de tu panel.

5. El famoso "Error de conexión a la base de datos" al instalar

Este es un error PrestaShop muy típico durante la instalación inicial, especialmente al migrar de un hosting a otro.

La causa raíz

Generalmente, ocurre porque los datos de la base de datos no coinciden o porque el prefijo de las tablas es diferente.

Solución detallada

Abre el archivo parameters.php como hicimos antes.
Revisa el valor de database_prefix. Si tu base de datos original usaba un prefijo como ps_ y ahora estás intentando usar otro como prestashop_, la instalación fallará.
Asegúrate de que el prefijo en el archivo coincida exactamente con el de las tablas en tu base de datos (puedes verlo en phpMyAdmin).
Verifica que el usuario de la base de datos tenga todos los privilegios sobre esa base de datos. En cPanel, puedes asignarlos desde "Bases de datos MySQL". En Plesk, desde "Bases de datos" > "Usuarios".

6. Errores de "No se puede cargar el módulo" o "Clase no encontrada"

Después de subir un módulo comprado o gratuito, a veces aparece un error fatal diciendo que la clase no se encuentra.

Solución práctica

Esto suele pasar por una mala subida de archivos. La estructura de carpetas del módulo no es la correcta.

Descarga el módulo en tu ordenador y descomprímelo.
Debe haber una carpeta con el nombre del módulo (ej: ps_banner).
Dentro de esa carpeta deben estar los archivos PHP, el .tpl, etc.
Sube esa carpeta completa a la ruta modules/ de tu instalación de PrestaShop, ya sea por FTP o por el Administrador de archivos de cPanel o Plesk.
Asegúrate de que los permisos de la carpeta del módulo sean 755 y los de los archivos 644.
Ve al back-office, a Módulos > Módulos y Servicios y busca el módulo. Ahora debería aparecer para poder instalarlo.

7. Problemas con el envío de correos electrónicos

Tu tienda no envía correos de confirmación de pedido. Este es un error PrestaShop muy común que no da un mensaje de error en pantalla, pero que afecta a la comunicación con el cliente.

Solución en cPanel y Plesk

Ve a Parámetros Avanzados > E-mail en tu back-office.
Cambia el método de envío a "Usar la función mail() de PHP" (recomendado para empezar).
Guarda y prueba enviando un correo de prueba.
Si sigue sin funcionar, cambia a "Usar servidor SMTP" y rellena los datos de tu servidor de correo (suelen ser mail.tudominio.com, puerto 587, con tu dirección de correo y contraseña).

[TIP]
Si usas Gmail o servicios externos, asegúrate de haber configurado las "aplicaciones menos seguras" o una contraseña de aplicación específica.

8. El error de "Página no encontrada" (404) en todas las URLs

Si la portada carga pero al hacer clic en un producto o categoría te da error 404, el problema es la reescritura de URLs (URL rewriting).

Solución rápida

Entra en el back-office (si puedes acceder, es buena señal).
Ve a Parámetros Avanzados > SEO y URLs.
Asegúrate de que la opción "Activar URLs amigables" esté marcada.
Pulsa "Guardar" para que PrestaShop regenere el .htaccess automáticamente.

Si no puedes acceder al back-office, tendrás que regenerar el .htaccess manualmente desde el Administrador de archivos, como vimos en el punto 1, o restaurar una copia de seguridad del archivo.

9. Cómo prevenir futuros errores PrestaShop

La prevención es la mejor medicina. Aquí tienes una lista de buenas prácticas para evitar estos sustos:

Mantén todo actualizado: PrestaShop, los módulos y el tema. Las actualizaciones corrigen bugs de seguridad y errores conocidos.
Haz copias de seguridad frecuentes: Tanto de los archivos como de la base de datos. La mayoría de los paneles (cPanel y Plesk) ofrecen herramientas automáticas.
No instales módulos pirata: Son la principal fuente de código malicioso y errores de compatibilidad.
Desactiva la caché cuando hagas cambios: Así verás los resultados al instante y evitarás confusiones.
Revisa los logs de errores: Tanto en cPanel (Error Logs) como en Plesk (Logs), te darán pistas exactas sobre qué está fallando.

[INFO]
Si tu hosting es muy limitado en recursos, considera migrar a un plan más potente o a un hosting especializado en PrestaShop. Muchos errores de memoria o tiempo de ejecución se solucionan simplemente con más recursos.

10. Preguntas frecuentes (FAQ) sobre errores PrestaShop

¿Qué hago si el back-office de PrestaShop no carga?

Prueba a vaciar la caché manualmente borrando el contenido de la carpeta var/cache (o cache). Si no funciona, desactiva todos los módulos no esenciales renombrando la carpeta modules a modules_backup y creando una nueva modules vacía. Luego, intenta acceder de nuevo.

¿Cómo sé si mi hosting usa cPanel o Plesk?

Normalmente, el enlace de acceso al panel lo recibes en el email de bienvenida del hosting. También puedes intentar acceder a tudominio.com/cpanel o tudominio.com:8443 (para Plesk) para ver cuál abre.

¿Es normal que PrestaShop dé errores tras una actualización de PHP?

Sí, es muy común. Los módulos antiguos no son compatibles con versiones nuevas de PHP (como PHP 8.0 o 8.1). Si tras una actualización de PHP en tu panel (cPanel o Plesk) la tienda falla, revisa los requisitos de tus módulos o contacta con el desarrollador.

¿Puedo arreglar estos errores sin contactar con el soporte?

En la mayoría de los casos, sí. Los pasos descritos en esta guía son seguros y los puede realizar cualquier persona con acceso al panel de control de su hosting. Eso sí, siempre haz una copia de seguridad antes de modificar nada.

¿Qué es Syspanel y tiene relación con cPanel o Plesk?

Syspanel es un panel de control de hosting alternativo, similar a cPanel o Plesk. Si tu proveedor usa Syspanel, el acceso se realiza a través del puerto 2106 (por ejemplo, tudominio.com:2106). La estructura de archivos y las opciones de configuración son muy similares a las de los otros paneles, por lo que los pasos de esta guía (buscar el Administrador de archivos, la base de datos, etc.) aplican de la misma manera.

Espero que esta guía extensa te haya sido de gran ayuda para resolver los **erro