Errores comunes en PrestaShop y cómo solucionarlos

¿Tu tienda PrestaShop se ha quedado en blanco o te muestra un error 500? Tranquilo, no eres el primero al que le pasa y, lo más importante, tiene solución. En este artículo vamos a desglosar los errores PrestaShop más comunes (desde la versión 8 hasta las más antiguas) y te voy a dar la solución errores PrestaShop paso a paso, sin tecnicismos raros y con un lenguaje claro.

Piensa en mí como tu compañero de soporte. Vamos a ir desde el error más temido (la prestashop página en blanco) hasta los fallos de configuración que te vuelven loco. Al final, tendrás una guía de referencia rápida para salvar tu negocio online.

El temido error 500 en PrestaShop (Internal Server Error)

El prestashop error 500 es, sin duda, el más frustrante. Un día tu tienda funciona y al siguiente, pum, todo se cae. La buena noticia es que este error casi nunca significa que hayas perdido tus datos. Solo es que el servidor no puede procesar la petición.

¿Por qué aparece el error 500?

Las causas más habituales suelen ser:

Un archivo .htaccess corrupto o con reglas incorrectas.
Un módulo recién instalado que genera un conflicto fatal.
Falta de memoria PHP (límite de memoria muy bajo).
Permisos de archivos o carpetas incorrectos.

Solución paso a paso para el error 500

Vamos a por ello. Sigue este orden, es el más efectivo:

Paso 1: Activa el modo debug de PrestaShop

Esto es clave. Necesitas ver el error real, no solo la pantalla blanca. Accede a tu servidor por FTP o al administrador de archivos de tu hosting y busca el archivo config/defines.inc.php. Dentro de él, busca esta línea:

define('_PS_MODE_DEV_', false);

Cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo y recarga tu tienda. Ahora verás un mensaje de error específico (por ejemplo, "Fatal error: Allowed memory size..."). Ese mensaje te dará la pista exacta.

[INFO] Si no sabes qué es FTP o no encuentras el archivo, contacta con tu soporte de hosting. En Syspanel (tu panel de control, accesible por el puerto 2106), tienes un gestor de archivos integrado que te facilita esta tarea.

Paso 2: Aumenta el límite de memoria PHP

Si el error menciona "memory size" o "allowed memory", el problema es la memoria. Edita el archivo config/settings.inc.php (en versiones antiguas) o crea un archivo llamado php.ini en la raíz de tu PrestaShop con este contenido:

memory_limit = 512M
max_execution_time = 300

Guarda y recarga. Esto soluciona el 80% de los errores 500.

Paso 3: Regenera el archivo .htaccess

A veces el archivo se corrompe. Ve a tu panel de administración de PrestaShop: Parámetros Avanzados > Rendimiento. Ahí, pulsa el botón "Guardar" sin cambiar nada. Esto fuerza a PrestaShop a regenerar el .htaccess. Si no tienes acceso al panel, borra el archivo .htaccess desde tu FTP (se regenerará solo al recargar la tienda, pero ten cuidado porque puede afectar a los enlaces amigables).

PrestaShop página en blanco: El misterio de la pantalla vacía

La prestashop página en blanco es una variante del error 500. La página se carga, pero no muestra absolutamente nada. Es como si la tienda estuviera vacía.

Causas comunes de la pantalla en blanco

Errores de PHP silenciados.
Un tema (template) con un fallo de código.
Conflictos entre módulos.
La caché de PrestaShop está guardando una versión corrupta.

Cómo arreglar la página en blanco

Paso 1: Activa el modo debug (como antes)

Sí, repetimos el truco. Es la única forma de ver qué está fallando. Activa _PS_MODE_DEV_ como te enseñé arriba.

Paso 2: Limpia la caché manualmente

A veces la caché guarda archivos rotos. Borra el contenido de la carpeta var/cache (en PrestaShop 8) o cache (en versiones antiguas). No borres la carpeta entera, solo su contenido. Puedes hacerlo por FTP o desde el gestor de archivos de Syspanel.

Paso 3: Desactiva todos los módulos no esenciales

Si la página vuelve a funcionar tras borrar la caché y el modo debug, el problema es un módulo. Ve a Módulos > Módulos y Servicios y ve desactivando los módulos de terceros uno a uno, recargando la tienda tras cada desactivación. Cuando la tienda vuelva a la normalidad, habrás encontrado al culpable.

[WARNING] Si no puedes acceder al panel de administración, renombra la carpeta modules por modules_backup desde el FTP. Esto desactiva todos los módulos a la vez. Si la tienda carga, ya sabes que es un módulo. Luego, ve moviendo los módulos de vuelta a la carpeta modules de uno en uno para identificar cuál falla.

Errores de conexión a la base de datos

Otro clásico. Verás un mensaje tipo "Link to database cannot be established" o "Error de conexión con la base de datos".

¿Por qué ocurre?

Cambiaste la contraseña de la base de datos y no actualizaste PrestaShop.
El servidor de base de datos está caído.
Los datos de conexión en el archivo parameters.php son incorrectos.

Solución rápida

Ve a la carpeta app/config/ y abre el archivo parameters.php.
Revisa los valores de database_host, database_name, database_user y database_password.
Asegúrate de que son correctos (puedes verificarlos en el panel de tu hosting, por ejemplo, en Syspanel en la sección de bases de datos MySQL).

Si acabas de cambiar la contraseña, este es el primer sitio donde debes actualizarla.

Error "Fatal error: Call to undefined function" o conflictos de versiones PHP

Este error es muy común si has actualizado PrestaShop o tu hosting ha cambiado la versión de PHP sin avisarte.

El problema

PrestaShop 8 necesita PHP 7.2.5 como mínimo (recomendado PHP 8.0 o 8.1). Si tu servidor tiene PHP 5.6 o una versión muy antigua, todo se rompe.

La solución

Accede a tu panel de control (Syspanel, recuerda, puerto 2106).
Busca la sección "Administrador de PHP" o "Versiones de PHP".
Selecciona una versión compatible con tu PrestaShop (por ejemplo, PHP 8.0 para PrestaShop 8.x).
Guarda los cambios y recarga tu tienda.

[TIP] Si tienes una versión antigua de PrestaShop (1.6 o 1.7), no te pases a PHP 8.0 directamente. Empieza con PHP 7.1 o 7.4 para evitar incompatibilidades con módulos antiguos.

Errores de permisos de archivos (carpetas no escribibles)

A veces verás avisos como "No se puede escribir en el archivo" o "El directorio no tiene permisos". Esto es más común al instalar módulos o temas.

La solución

Los permisos correctos para PrestaShop son:

Carpetas: 755
Archivos: 644

Puedes cambiar los permisos desde el gestor de archivos de Syspanel o desde tu cliente FTP (FileZilla). Selecciona la carpeta de PrestaShop, haz clic derecho y elige "Permisos de archivos" (o "File permissions"). Pon 755 para carpetas y 644 para archivos.

[WARNING] No uses permisos 777 (todos pueden escribir). Es un riesgo de seguridad enorme. Si un módulo te pide 777, busca alternativas o contacta con soporte.

Preguntas Frecuentes (FAQ) sobre errores de PrestaShop

Aquí tienes las dudas que más me llegan al chat de soporte:

¿Por qué mi PrestaShop se actualizó solo y ahora da error 500?

PrestaShop no se actualiza solo. Lo que sí puede pasar es que tu hosting haya actualizado la versión de PHP. Revisa la versión de PHP en Syspanel y ajústala a la que necesite tu versión de PrestaShop.

He borrado la caché y ahora mi tienda está en blanco, ¿qué hago?

Activa el modo debug (como te enseñé arriba). Si no muestra nada, probablemente el problema es un módulo o el tema. Prueba a renombrar la carpeta themes a themes_backup (ten cuidado, esto cambiará el diseño). Si funciona, el tema es el culpable.

¿Cómo sé qué versión de PHP tengo?

Ve a Parámetros Avanzados > Información en tu panel de administración de PrestaShop. Ahí verás la versión de PHP, la de PrestaShop y otros datos útiles.

¿Puedo usar "Syspanel" para arreglar estos errores?

Sí, Syspanel es tu mejor aliado. Desde ahí puedes gestionar archivos, bases de datos y la versión de PHP. Accede normalmente por el puerto 2106 (ej: tu-dominio.com:2106). Si no tienes acceso, pídeselo a tu proveedor de hosting.

Mi tienda da error solo en el carrito o al pagar, ¿es un error de PrestaShop?

Eso suele ser un conflicto con un módulo de pago o de envío. Desactiva los módulos de pago que no uses y prueba con el pago por defecto (transferencia bancaria) para ver si funciona. Si sí, el problema es la pasarela de pago.

Consejos finales para evitar futuros errores en PrestaShop

La prevención es mejor que la cura. Toma nota de estos hábitos:

Haz copias de seguridad antes de tocar cualquier cosa (módulos, temas, actualizaciones). Puedes hacerlo desde tu hosting o con módulos de backup.
Actualiza PrestaShop, los módulos y el tema regularmente. Las actualizaciones corrigen bugs y vulnerabilidades.
No instales módulos piratas. Son la principal causa de errores y brechas de seguridad.
Mantén un entorno de pruebas (un subdominio tipo test.tudominio.com) para probar cambios antes de aplicarlos en tu tienda real.

Resumen rápido: Solución de errores comunes

Error	Síntoma	Solución Rápida
Error 500	Página no carga, mensaje genérico	Activar debug, aumentar memoria PHP, regenerar .htaccess
Página en blanco	Pantalla vacía, sin texto	Activar debug, limpiar caché, desactivar módulos
Error DB	"Link to database cannot be established"	Revisar `parameters.php`, verificar credenciales en Syspanel
Error de PHP	"Call to undefined function"	Cambiar la versión de PHP desde Syspanel a una compatible
Permisos	"No se puede escribir"	Cambiar permisos a 755 (carpetas) y 644 (archivos)

Espero que esta guía te haya sido de ayuda. Recuerda que los errores PrestaShop son parte del día a día de cualquier tienda online, pero con paciencia y siguiendo estos pasos, los resolverás sin necesidad de ser un experto. Si te quedas atascado, no dudes en preguntar a tu soporte de hosting (si usas Syspanel, el acceso es por el puerto 2106) o en los foros oficiales de PrestaShop. ¡Mucho ánimo y a por esas ventas!