Errores comunes de PrestaShop y cómo solucionarlos

Respuesta rápida: en PrestaShop, cuando algo falla lo primero SIEMPRE es lo mismo: activar el modo debug para que el error deje de estar oculto tras una página en blanco. La mayoría de fallos son un módulo o un override incompatible, permisos mal puestos o la caché corrupta. Abajo, cada caso con su arreglo.

Antes de tocar nada: copia de seguridad

Backup completo (archivos + base de datos) antes de editar config/defines.inc.php, tocar permisos o borrar caché. Trabaja por FTP; el back office puede estar caído.

El primer paso para casi todo: activar el modo debug

Una página en blanco o un error 500 esconden el error real. Para verlo:

1. Edita por FTP el archivo config/defines.inc.php.
2. Busca la línea del modo desarrollo y ponla a true:

   define('_PS_MODE_DEV_', true);

3. Recarga la página: ahora verás el error concreto (un módulo, memoria, un override…).
4. Vuelve a ponerlo en false al terminar. Dejar el modo debug activo en producción expone información del servidor.

[CAPTURA: config/defines.inc.php con _PS_MODE_DEV_ en true y el error real que aparece al recargar — es como diagnosticamos cualquier fallo de PrestaShop.]

Tabla rápida: síntoma → causa probable → qué hacer

Lo que ves	Causa más frecuente	Primer paso
Página en blanco	Módulo/override o memoria	Activar debug para ver el error
Error 500	Permisos, memoria o .htaccess	Debug + permisos 755/644
«Invalid security token»	Enlace antiguo del back office	Entrar desde la URL actual
No entro al back office	Carpeta admin, cookies o caché	Usar el nombre real de la carpeta admin
La tienda va lenta	Caché, imágenes y módulos	Activar caché y CCC
Error al instalar un módulo	Permisos, memoria o versión	Comprobar compatibilidad y permisos

Error 500 en PrestaShop

El 500 es genérico. Con el debug ya activado, ve descartando:

1. Mira el error real con _PS_MODE_DEV_ en true (arriba).
2. Permisos: carpetas en 755 y archivos en 644.
3. Memoria PHP: súbela a 256M o más.
4. Módulo u override: si el error apunta a uno, desactívalo renombrando su carpeta en /modules y borra la caché en var/cache.
5. .htaccess: regenéralo desde Parámetros de SEO y URLs del back office.

«Invalid security token» al entrar al back office

Este aviso sale al acceder al back office desde un enlace antiguo o tras cambiar la URL. No es un fallo grave:

1. Pulsa «I understand the risks…» para continuar de forma puntual.
2. Entra siempre desde la URL actual de tu back office, no desde enlaces o favoritos guardados.
3. Borra la caché del navegador.

Puedes desactivar el token en los parámetros avanzados, pero no lo recomendamos: es una capa de seguridad del panel.

No puedo acceder al back office

1. Carpeta admin: PrestaShop renombra la carpeta de administración por seguridad (algo como admin1234xyz). Usa el nombre correcto; si no lo recuerdas, míralo por FTP.
2. Cookies: bórralas y prueba en incógnito.
3. Caché: elimina por FTP el contenido de var/cache.
4. Contraseña: recupérala por email o, si el correo no sale, cámbiala en la tabla ps_employee de la base de datos con phpMyAdmin.

PrestaShop va lento

Con catálogos grandes, la velocidad pesa aún más. No es un error, pero cuesta ventas y posiciones. Lo tratamos a fondo en cómo acelerar PrestaShop; en resumen:

• Caché: actívala, junto con la de plantillas (Smarty), en Parámetros avanzados → Rendimiento.
• CCC: activa «Combinar, comprimir y cachear» CSS/JS.
• Imágenes: regenera las miniaturas y comprime; usa formatos modernos.
• Módulos: desinstala los que no uses; cada uno añade carga.
• Hosting: un servidor con recursos de verdad marca la diferencia con PrestaShop.

Error al instalar un módulo

1. Comprueba que el módulo es compatible con tu versión de PrestaShop.
2. Revisa permisos de escritura en la carpeta /modules.
3. Sube el límite de subida y la memoria PHP si el módulo es grande.
4. Si el panel falla al subirlo, súbelo por FTP a /modules e instálalo desde el back office.
5. Borra var/cache después de instalar.

Cómo evitar que vuelva a pasar

• Instala módulos con cabeza: solo de fuentes fiables y compatibles con tu versión, y prueba la tienda después de cada uno.
• Backups diarios comprobados antes de cualquier actualización o instalación.
• Borra la caché (var/cache) tras cambios importantes; muchos «fallos» son caché vieja.
• Un hosting a la altura de PrestaShop, que es más exigente que un WordPress sencillo.

¿Te ayudamos con tu PrestaShop?

Mantenemos y reparamos tiendas PrestaShop desde Girona. Si la tienda da error 500, no entras al back office o va lentísima con tu catálogo, escríbenos por WhatsApp: lo miramos y te decimos qué pasa, sin compromiso.