Errores Comunes en PrestaShop y Cómo Solucionarlos (Guía Práctica)

Primeros pasos: identifica el error antes de tocar nada

Cuando tu tienda online da problemas, la tentación es entrar a toda prisa a cambiar archivos o desinstalar módulos. Es un error muy común. Antes de solucionar prestashop, necesitas saber exactamente qué está fallando. Presta atención a los síntomas: ¿la página sale en blanco? ¿Aparece un mensaje de error concreto? ¿Solo falla al pagar? ¿O es que no carga el panel de administración?

Anota lo que ves, porque ese dato es oro para el soporte prestashop. Si tienes acceso al panel de control de tu hosting, revisa los logs de error. En la mayoría de paneles, como Syspanel (accesible a través del puerto 2106), puedes ver los registros del servidor en la sección de "Logs" o "Registros". Ahí encontrarás la pista definitiva sobre el origen del fallo. Si no te ves con confianza, no pasa nada: esta guía te lleva paso a paso por los errores prestashop más habituales y sus soluciones.

Error 500: la página en blanco o el "Internal Server Error"

Este es, con diferencia, uno de los errores prestashop más temidos. De repente, tu tienda online muestra una pantalla en blanco o el famoso "500 Internal Server Error". No te asustes: en el 90% de los casos tiene solución sencilla.

¿Qué lo causa?

El error 500 suele deberse a un problema de permisos de archivos, un archivo .htaccess corrupto o un módulo incompatible que está rompiendo la tienda. También puede aparecer tras una actualización fallida de PrestaShop o de un tema.

Cómo solucionarlo paso a paso

Revisa los permisos de archivos y carpetas. Desde tu panel de control (recuerda, Syspanel en el puerto 2106) o mediante FTP, asegúrate de que las carpetas tengan permiso 755 y los archivos 644. Las carpetas cache, log y config a veces necesitan 775 si tu hosting usa PHP como módulo de Apache.
Regenera el archivo .htaccess. Ve a tu panel de administración de PrestaShop (si puedes acceder). Si no puedes, tendrás que hacerlo por FTP: renombra el archivo .htaccess a .htaccess_old y luego entra a tu tienda. PrestaShop lo regenerará automáticamente si el servidor tiene permisos de escritura.
Desactiva el modo de depuración temporalmente. Si no ves nada, activa el modo debug para ver el error exacto. Edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Esto mostrará el mensaje de error real en pantalla. Anótalo y luego vuelve a ponerlo en false.
Revisa la memoria PHP. A veces el error 500 aparece por falta de memoria. Sube el límite a 256M en tu archivo php.ini o desde el panel de control de tu hosting.

[WARNING] Si activas el modo debug, tu tienda online mostrará errores técnicos a los visitantes. Hazlo solo durante unos minutos y desactívalo después. No lo dejes activo nunca en producción.

Error de conexión a la base de datos

Otro clásico entre los errores prestashop. Tu tienda online carga pero te dice que no puede conectarse a la base de datos, o directamente te muestra un mensaje de instalación. Esto significa que PrestaShop no encuentra o no puede autenticarse contra MySQL/MariaDB.

Causas habituales

Cambiaste la contraseña de la base de datos y no actualizaste el archivo de configuración.
El servidor de base de datos está caído o saturado.
Se modificaron los parámetros de conexión en el hosting.

Solución práctica

Localiza el archivo app/config/parameters.php (en PrestaShop 1.7 y 1.8) o config/settings.inc.php (en versiones antiguas). Ábrelo con un editor de texto.
Verifica los datos de conexión: database_host, database_name, database_user y database_password. Deben coincidir exactamente con los que tienes en tu panel de control.
Si no los recuerdas, entra a Syspanel (puerto 2106), ve a la sección de bases de datos y restablece la contraseña. Luego actualiza el archivo de configuración con la nueva.
Comprueba que el servidor de base de datos está activo. En tu panel de hosting deberías ver el estado del servicio MySQL. Si está apagado, actívalo.
Asegúrate de que el usuario tiene todos los privilegios sobre la base de datos. A veces, al crear un usuario nuevo, solo se le dan permisos parciales. Revisa que tenga ALL PRIVILEGES sobre la base de datos de tu tienda.

[TIP] Guarda siempre una copia de seguridad de parameters.php en un lugar seguro. Si algo se corrompe, puedes restaurarlo sin perder tiempo.

Error "No se puede cargar el módulo" o módulos que fallan

Los módulos son el alma de PrestaShop, pero también la fuente de muchos prestashop fallos. Si un módulo se actualiza mal, o es incompatible con tu versión, puede romper toda la tienda online.

¿Cómo detectar el módulo problemático?

Ve a tu panel de administración y entra en "Módulos" > "Administrador de módulos".
Busca módulos con estado "anormal" o que aparezcan en rojo. Desactívalos uno a uno para ver cuál causa el fallo.
Si no puedes acceder al panel, tendrás que hacerlo por FTP. Renombra la carpeta del módulo sospechoso dentro de /modules. Por ejemplo, si crees que el problema es paypal, renómbrala a paypal.bak. Esto lo desactiva sin necesidad de entrar al panel.

Prevención de futuros problemas

Actualiza los módulos solo desde el marketplace oficial de PrestaShop o desde el sitio del desarrollador.
Haz una copia de seguridad antes de actualizar cualquier módulo. En Syspanel tienes herramientas de backup o puedes hacerlo desde el propio panel de PrestaShop.
Lee las reseñas y la compatibilidad antes de instalar un módulo nuevo. Asegúrate de que es compatible con tu versión de PrestaShop.

[INFO] Los módulos gratuitos del marketplace oficial suelen pasar controles de calidad, pero no son infalibles. Los módulos de terceros pueden ser más arriesgados. Siempre que puedas, pruébalos en un entorno de pruebas antes de llevarlos a producción.

Error de caché: la tienda muestra datos antiguos o no actualiza

A veces tu tienda online funciona, pero ves productos, precios o configuraciones que no se corresponden con lo que has cambiado. Esto es un problema de caché, muy común en PrestaShop.

Solución rápida

Ve a "Parámetros avanzados" > "Rendimiento" en tu panel de administración.
Pulsa el botón "Vaciar la caché" (o "Limpiar caché"). Esto borra la caché de Smarty y de la tienda.
Si no puedes entrar al panel, borra manualmente el contenido de las carpetas var/cache (en PrestaShop 1.7+) o cache (en versiones antiguas). No borres las carpetas en sí, solo su contenido. Usa FTP o el administrador de archivos de Syspanel.
Desactiva la caché de Smarty temporalmente para pruebas. En "Rendimiento", establece "Recompilar plantillas" en "Forzar compilación" y "Caché" en "No". Cuando termines, vuelve a activarla.

[WARNING] Si tienes una caché de servidor activada (como Varnish o LiteSpeed Cache) además de la de PrestaShop, tendrás que purgarla también desde el panel de tu hosting. De lo contrario, los cambios seguirán sin verse.

Error al subir imágenes o "No se puede crear el directorio"

¿Has intentado subir una imagen de producto y te da error? ¿O al guardar un producto te dice que no puede crear el directorio? Esto suele ser un problema de permisos en la carpeta img o de espacio en disco.

Pasos para resolverlo

Comprueba el espacio libre en tu hosting. Si el disco está lleno, nada funciona correctamente. Entra a Syspanel y revisa el uso de disco.
Revisa los permisos de la carpeta img y sus subcarpetas. Debe tener permisos 755 o 775 en la mayoría de los casos. Si tu servidor usa PHP-FPM, a veces necesitas 755 para las carpetas y 644 para los archivos.
Comprueba los límites de subida de PHP. Si el error dice "archivo demasiado grande", tendrás que aumentar upload_max_filesize y post_max_size en tu php.ini. Normalmente, 20M es suficiente para imágenes de producto, pero si usas imágenes de alta resolución, quizá necesites más.
Si el error persiste, regenera las miniaturas. Ve a "Parámetros avanzados" > "Rendimiento" y pulsa en "Regenerar miniaturas". Esto reconstruye todas las imágenes de la tienda y suele arreglar problemas de imágenes corruptas.

Error "No se pudo conectar a la pasarela de pago"

Los errores prestashop relacionados con pagos son críticos, porque afectan directamente a tus ventas. Si el cliente llega al paso final y ve un error, se va a la competencia.

Causas frecuentes

Claves API incorrectas en la configuración del módulo de pago.
El servidor no puede comunicarse con la pasarela porque tiene bloqueada la salida por ciertos puertos o porque hay un firewall.
La URL de notificación (webhook) no es accesible desde internet.

Solución

Revisa las claves API en la configuración del módulo de pago. Asegúrate de que las has copiado correctamente desde el panel de la pasarela (PayPal, Stripe, etc.).
Comprueba que la URL de tu tienda es correcta y que es accesible desde fuera. A veces, si tienes la tienda en un entorno de pruebas o con una URL temporal, las pasarelas rechazan la conexión.
Prueba con el modo sandbox de la pasarela para ver si el problema es de configuración o de conexión. Si en sandbox funciona, el problema está en las claves de producción.
Si tu hosting tiene firewall, asegúrate de que permite conexiones salientes por HTTPS (puerto 443). La mayoría de pasarelas funcionan por ese puerto.

[TIP] Si usas un CDN o un proxy inverso, asegúrate de que no esté bloqueando las notificaciones de la pasarela de pago. Algunos CDN filtran solicitudes POST que no vienen de navegadores.

Error "La página no redirige correctamente" o bucles de redirección

Este es otro de los prestashop fallos más molestos. Entras a tu tienda y tu navegador te dice que la página no redirige correctamente, o ves un bucle infinito entre dos URLs.

Qué lo causa

Configuración incorrecta de URLs amigables en PrestaShop.
El archivo .htaccess tiene reglas de redirección conflictivas.
La tienda está configurada con una URL distinta a la que usas para acceder.

Solución

Ve a "Parámetros avanzados" > "URLs" en tu panel de administración. Asegúrate de que la URL de tu tienda es exactamente la que usas en el navegador (con o sin www, con http o https, pero siempre coherente).
Regenera el .htaccess como explicamos antes. A veces las reglas antiguas se quedan grabadas y causan conflictos.
Desactiva las URLs amigables temporalmente. En "Parámetros avanzados" > "URLs", desmarca la opción "Usar URL amigable". Si la tienda funciona así, el problema está en el archivo .htaccess o en la configuración de las URLs amigables. Vuelve a activarlas y regenera el archivo.
Comprueba que no tienes redirecciones forzadas en tu hosting (por ejemplo, forzar HTTPS) que entren en conflicto con la configuración de PrestaShop.

Error de actualización: "La versión de PHP no es compatible"

Si intentas actualizar PrestaShop o instalar un módulo nuevo y te sale un aviso de que tu versión de PHP no es compatible, tienes un problema de entorno.

Qué hacer

Comprueba qué versión de PHP tiene tu hosting. Entra a Syspanel (puerto 2106) y busca la sección de "PHP" o "Gestor de versiones".
Actualiza PHP a una versión compatible con tu PrestaShop. Las versiones modernas de PrestaShop (1.7.8 y superiores) funcionan bien con PHP 7.4, 8.0 o 8.1. Si tienes PHP 5.6, estás muy desactualizado y no podrás usar módulos modernos.
Antes de cambiar la versión de PHP, haz una copia de seguridad completa de tu tienda. Algunos módulos antiguos no son compatibles con PHP 8 y podrían romperse.
Si algún módulo no funciona después del cambio de PHP, actualízalo a su última versión o contacta con el desarrollador. Si no tiene versión compatible, tendrás que buscar un módulo alternativo.

[INFO] PrestaShop 1.6 y anteriores no son compatibles con PHP 7.4 o superior. Si tienes una versión antigua, te recomendamos encarecidamente migrar a una versión moderna, no solo por compatibilidad sino por seguridad.

El panel de administración no carga o da error 500

A veces la tienda online funciona perfectamente, pero no puedes acceder al panel de administración. Esto es especialmente frustrante porque no puedes gestionar nada.

Solución paso a paso

Prueba a acceder con una URL distinta. Si tienes el panel en /admin, prueba a añadir un parámetro como /admin/index.php. A veces el problema es de caché del navegador.
Borra la caché de tu navegador o prueba con otro navegador o en modo incógnito.
Revisa los permisos de la carpeta admin. Debe tener los mismos permisos que el resto de carpetas (755).
Si el error es 500, activa el modo debug como explicamos antes para ver el mensaje exacto. Suele ser un módulo que se ha actualizado mal o un problema de memoria.
Renombra la carpeta admin por FTP. Esto hará que PrestaShop te pida una nueva URL de administración, pero a veces soluciona problemas de acceso. Después, tendrás que actualizar la URL en el archivo de configuración.

Preguntas frecuentes (FAQ) sobre errores PrestaShop

¿Puedo solucionar errores PrestaShop sin conocimientos técnicos?

Sí, muchos errores comunes tienen soluciones sencillas que puedes aplicar siguiendo guías como esta. Sin embargo, si no te sientes seguro, es mejor contactar con un profesional o con el soporte prestashop de tu hosting. Forzar cambios puede empeorar las cosas.

¿Cada cuánto debo hacer copias de seguridad?

Idealmente, cada día si tu tienda tiene movimiento. Como mínimo, cada semana. Las copias de seguridad son tu salvavidas ante cualquier error prestashop grave. En Syspanel puedes configurar copias automáticas fácilmente.

¿Por qué mi tienda online va lenta? ¿Es un error?

La lentitud no es un error en sí, pero puede ser un síntoma de problemas de configuración, caché mal ajustada, módulos pesados o un servidor insuficiente. Si tu tienda tarda más de 3-4 segundos en cargar, pierdes ventas. Revisa la caché, optimiza las imágenes y considera actualizar tu plan de hosting.

¿Qué hago si mi tienda se ha roto después de una actualización?

Primero, no entres en pánico. Revisa si tienes una copia de seguridad reciente. Si la tienes, restaura la tienda desde esa copia. Si no, contacta con soporte prestashop o con un