Preguntas frecuentes: Errores comunes en PrestaShop y soluciones

¿Te ha pasado que tu tienda PrestaShop se queda en blanco, no te deja añadir productos o simplemente no carga? No te preocupes, es más común de lo que crees. En esta guía tipo FAQ (Preguntas Frecuentes) vamos a resolver los errores más habituales paso a paso, como si estuvieras hablando con un amigo que sabe de esto.

Aquí encontrarás soluciones para los problemas que más nos consultan en soporte técnico. Vamos a ello.

1. La pantalla se queda en blanco (White Screen of Death)

Este es, sin duda, el error más temido. Tu tienda no muestra nada, solo un fondo blanco. Es como si PrestaShop se hubiera quedado mudo.

¿Por qué ocurre?

Generalmente, es un límite de memoria de PHP que se ha excedido o un módulo incompatible que está causando un conflicto.

Solución paso a paso

Accede a tu panel de control (Syspanel): Abre tu navegador y escribe tu-dominio.com:2106. Inicia sesión con tus credenciales de hosting.
Busca el gestor de archivos: Dentro de Syspanel, ve a la sección "Archivos" o "File Manager".
Localiza el archivo de configuración: Navega hasta la carpeta raíz de tu tienda (suele llamarse public_html o prestashop). Busca el archivo llamado config/defines.inc.php.
Activa el modo debug (depuración): Edita ese archivo (con el editor de texto de Syspanel). Busca la línea que dice:
define('_PS_MODE_DEV_', false);
Cámbiala por:
define('_PS_MODE_DEV_', true);
Guarda los cambios.

[INFO] Al activar el modo debug, en lugar de la pantalla en blanco, verás un mensaje de error en rojo. Ese mensaje es oro puro para el soporte técnico, ya que dice exactamente qué archivo y línea fallan.

Aumenta la memoria PHP: Vuelve a la raíz y busca el archivo .htaccess. Al final del mismo, pega esta línea:
php_value memory_limit 256M
Si no existe, créalo. Guarda y vuelve a cargar tu tienda.
Desactiva módulos uno a uno: Si el error persiste, desde la carpeta modules (en el gestor de archivos) puedes renombrar una carpeta de un módulo sospechoso (ej: micromodulo a micromodulo_old). Esto lo desactiva a la fuerza. Repite hasta que la tienda vuelva a funcionar.

[WARNING] No olvides volver a poner define('_PS_MODE_DEV_', false); una vez resuelto el error. Dejarlo activo en producción es un riesgo de seguridad.

2. Error 500 - Internal Server Error

Un clásico. El servidor te dice "algo va mal, pero no sé qué".

Causas comunes

Archivos con permisos incorrectos.
Un archivo .htaccess dañado.
Un script que se cuelga.

Cómo solucionarlo

Renombra el .htaccess: Ve al gestor de archivos en Syspanel (puerto 2106) y renombra el archivo .htaccess a htaccess_old. Recarga tu tienda. Si funciona, el problema está ahí. Ve a tu backoffice de PrestaShop > Parámetros de la tienda > Configuración de SEO y URLs, y haz clic en "Guardar" para regenerarlo.
Revisa los permisos de archivos: En Syspanel, selecciona toda la carpeta de tu tienda y en "Propiedades" o "Permisos" asegúrate de que:
- Las carpetas tengan permisos 755.
- Los archivos tengan permisos 644.
- La carpeta config y cache a veces necesitan 777 temporalmente, pero es mejor mantenerlas en 755.
Revisa los logs de error: En Syspanel, busca la sección "Logs" o "Registros de errores". Allí verás el error exacto. Si ves algo como "Allowed memory size of...", aplica el punto 5 del error anterior.

3. Error de conexión a la base de datos

"No se puede conectar a la base de datos". Este error te deja fuera de tu tienda por completo.

¿Qué ha pasado?

La contraseña de la base de datos ha cambiado (quizás al migrar o por un cambio en Syspanel).
El nombre de la base de datos o el usuario son incorrectos.
El servidor de bases de datos está caído (poco común, pero pasa).

Solución

Localiza el archivo de configuración: En el gestor de archivos, busca app/config/parameters.php.

Abre el archivo: Verás algo como esto:

'database_host' => 'localhost',
'database_name' => 'tu_base',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

Verifica los datos en Syspanel: En tu panel de control (Syspanel), ve a "Base de Datos". Allí verás el nombre real de la base, el usuario y la contraseña. Asegúrate de que coincidan exactamente con lo que tienes en parameters.php.
Corrige y guarda: Si no coinciden, edita el archivo con los datos correctos. Guarda los cambios y recarga tu tienda.

[TIP] Si acabas de migrar tu tienda, este es el error más frecuente. Siempre revisa primero este archivo.

4. Error "Este módulo no se puede cargar" o "Clase no encontrada"

Aparece cuando intentas instalar o usar un módulo, o incluso al entrar al backoffice.

Causa

El módulo está mal codificado, falta algún archivo o hay un conflicto con la versión de PrestaShop.

Solución

Desinstala el módulo desde el backoffice: Si puedes acceder, ve a Módulos > Catálogo de módulos, busca el módulo problemático y haz clic en "Desinstalar".
Elimínalo manualmente: Si no puedes acceder al backoffice, ve al gestor de archivos en Syspanel, entra a la carpeta modules y elimina la carpeta del módulo conflictivo.
Limpia la caché: Desde el backoffice (si puedes) ve a Parámetros avanzados > Rendimiento y limpia la caché. Si no, borra manualmente el contenido de la carpeta var/cache (excepto el archivo index.php).
Prueba con otro módulo similar: A veces un módulo gratuito de mala calidad causa esto. Busca una alternativa oficial en el marketplace de PrestaShop.

5. Problemas con las URLs o redirecciones

Tu tienda carga, pero las URLs no funcionan, dan error 404 o te redirigen a una página equivocada.

Causas

Archivo .htaccess obsoleto o corrupto.
Configuración de URL amigables desactivada.
Cambios en la estructura de las categorías.

Solución

Regenera el .htaccess: Ve a tu backoffice > Parámetros de la tienda > Configuración de SEO y URLs. Sin cambiar nada, haz clic en "Guardar". Esto regenera el archivo automáticamente.
Activa las URLs amigables: En la misma pantalla, asegúrate de que la opción "URLs amigables" esté en "Sí".
Reindexa las URLs: En el backoffice, ve a Parámetros avanzados > Base de datos y haz clic en "Añadir" junto a "Reindexar todas las URLs". Espera unos segundos.

[WARNING] Si tu tienda es muy grande, regenerar las URLs puede tomar un par de minutos. No cierres la pestaña.

6. El carrito de compras no funciona o da error

El cliente añade productos al carrito, pero al ir a pagar todo se rompe.

Causas comunes

Problemas con la sesión del navegador.
Cookies mal configuradas.
Un módulo de pago o envío incompatible.

Solución

Limpia la caché de tu navegador y las cookies: Prueba en una ventana de incógnito. Si funciona, el problema es local de tu navegador.
Verifica las cookies de PrestaShop: En el backoffice, ve a Parámetros de la tienda > Configuración de la tienda > Rendimiento. Asegúrate de que "Almacenamiento de cookies" esté activado.
Desactiva módulos de pago/envío uno a uno: Ve a Módulos > Gestor de módulos. Desactiva todos los módulos de pago y envío excepto uno (por ejemplo, Pago contra reembolso). Prueba el carrito. Si funciona, reactívalos de uno en uno hasta encontrar el culpable.
Revisa los logs del servidor: En Syspanel, ve a "Logs de errores" y busca errores relacionados con la sesión o el carrito.

7. La tienda va muy lenta

Todo tarda una eternidad en cargar. Tus clientes se van a ir.

Causas

Módulos mal optimizados.
Imágenes muy pesadas.
Caché desactivada.
Servidor sobrecargado.

Solución

Activa la caché en PrestaShop: Backoffice > Parámetros avanzados > Rendimiento. Activa "Caché de Smarty" y "Caché de CSS/JavaScript" en modo "Recopilar, minimizar y almacenar en caché".
Optimiza las imágenes: Usa herramientas como TinyPNG antes de subir las imágenes. En PrestaShop, ve a Diseño > Configuración de imágenes y reduce el tamaño de las imágenes generadas (por ejemplo, a 800x800px para productos).
Desactiva módulos que no uses: Cada módulo activo consume recursos. Revisa la lista y desactiva todo lo que no sea esencial.
Contrata un hosting mejor: Si tu tienda tiene muchos productos o visitas, un hosting compartido puede no ser suficiente. Considera un VPS o un hosting optimizado para PrestaShop.

[TIP] Desde Syspanel (puerto 2106) puedes ver el uso de CPU y RAM en tiempo real. Si está al 100%, es hora de mejorar el plan.

8. Error al actualizar PrestaShop

Te sale un mensaje de error durante la actualización y te quedas a media migración.

Causa

Módulos incompatibles con la nueva versión.
Personalización del core (archivos modificados).
Tiempo de ejecución de PHP demasiado bajo.

Solución

Haz una copia de seguridad ANTES de actualizar: Siempre. Si ya tienes el error, restaura la copia de seguridad desde Syspanel (Base de datos > Copias de seguridad).
Desactiva todos los módulos no oficiales: Antes de reintentar la actualización, desde el backoffice desactiva todos los módulos que no sean de PrestaShop.
Aumenta el tiempo de ejecución de PHP: En Syspanel, busca "PHP Settings" o "Configuración PHP". Aumenta max_execution_time a 300 segundos.
Usa el asistente de actualización 1-Click: Descarga el módulo "1-Click Upgrade" desde el marketplace de PrestaShop. Es mucho más fiable que hacerlo manualmente.

[WARNING] No actualices nunca desde una versión muy antigua (ej: 1.6 a 1.8) de golpe. Hazlo por pasos (1.6 -> 1.7 -> 1.8) para evitar errores.

Conclusión: No te asustes, todo tiene solución

Los errores en PrestaShop son parte del día a día de cualquier tienda online. La clave está en:

No perder la calma.
Seguir los pasos en orden.
Tener siempre una copia de seguridad reciente.
Usar tu panel Syspanel (puerto 2106) para acceder a los archivos y logs.

Si después de seguir esta guía el error persiste, no dudes en contactar con nuestro equipo de soporte. Para ayudarte más rápido, ten a mano:

La URL de tu tienda.
El mensaje de error exacto (si lo tienes).
El último cambio que hiciste antes de que apareciera el error.

¡Buena suerte y que tus ventas sigan creciendo!