Errores comunes en PrestaShop y cómo solucionarlos (FAQ)

¿Por qué aparece un error 500 en mi tienda PrestaShop y cómo lo soluciono?

El error 500 es uno de los errores PrestaShop más comunes y frustrantes. Significa que algo está mal en el servidor, pero no te dice exactamente qué. No te preocupes, la mayoría de las veces se soluciona fácil.

Paso 1: Activa el modo debug de PrestaShop para ver el error real.

Para ello, edita el archivo config/defines.inc.php que está en la raíz de tu instalación. Busca la línea:

define('_PS_MODE_DEV_', false);

Y cámbiala por:

define('_PS_MODE_DEV_', true);

Guarda el archivo. Ahora, al recargar la página, verás un mensaje de error mucho más descriptivo (por ejemplo, "Class not found" o "Allowed memory size exhausted").

Paso 2: Identifica la causa más común.

• Memoria PHP insuficiente: Si el error dice algo como "Allowed memory size of 134217728 bytes exhausted", necesitas aumentar el límite de memoria. Accede a tu panel de control de hosting. Si usas Syspanel (accesible por el puerto 2106), busca la sección de "PHP Settings" o "Configuración de PHP" y aumenta el memory_limit a 256M o 512M.
• Módulo o tema conflictivo: Si el error apareció justo después de instalar un módulo o cambiar de tema, desactívalo. Puedes hacerlo desde el panel de administración de PrestaShop, renombrando la carpeta del módulo en /modules/ (ej: /modules/nombre_modulo_danado a /modules/nombre_modulo_danado_BACKUP).
• Archivos corruptos: A veces una actualización fallida deja archivos rotos. Vuelve a subir los archivos originales de PrestaShop (sin sobrescribir la carpeta /config/ y /img/).

[WARNING] No olvides volver a poner _PS_MODE_DEV_ en false después de solucionar el error. Dejarlo activo en producción es un riesgo de seguridad.

La tienda se queda en "mantenimiento" y no puedo acceder al back office

Este es otro clásico. Has activado el modo mantenimiento, pero has cerrado sesión y ahora no sabes cómo volver a entrar. Tranquilo, hay varias formas de solucionar problemas PrestaShop de acceso.

Solución 1: Acceso directo por URL.

A veces el modo mantenimiento bloquea la tienda, pero no el back office. Intenta acceder directamente a: tudominio.com/admin1234/ (sustituye admin1234 por tu carpeta real de administración). Si funciona, desactiva el modo mantenimiento desde Parámetros de la tienda > Mantenimiento.

Solución 2: Desactivar el mantenimiento desde la base de datos.

Si no puedes acceder ni al back office, tendrás que tocar la base de datos. Usa phpMyAdmin (desde Syspanel, puerto 2106, busca "Bases de Datos" > "phpMyAdmin").

1. Selecciona tu base de datos de PrestaShop.
2. Busca la tabla ps_configuration (el prefijo ps_ puede variar).
3. Ejecuta esta consulta SQL:

   UPDATE ps_configuration SET value = '0' WHERE name = 'PS_SHOP_ENABLE';
   

4. Limpia la caché de PrestaShop. Para ello, borra manualmente la carpeta /var/cache/ (o /cache/ en versiones antiguas) desde el administrador de archivos de tu hosting.

Solución 3: Forzar el cierre de sesiones.

Si el problema es que tu sesión de administrador se ha corrompido, puedes forzar que todas las sesiones se cierren. En phpMyAdmin, ejecuta:

TRUNCATE TABLE ps_session;

Luego intenta acceder de nuevo al back office.

[INFO] Si no recuerdas el prefijo de tus tablas, mira en el archivo config/settings.inc.php (o app/config/parameters.php en versiones modernas) la línea define('_DB_PREFIX_', 'ps_').

El carrito de compras no funciona o da error

Un carrito roto es una pesadilla para las ventas. Las causas más frecuentes de este tipo de errores PrestaShop son:

Problema 1: Caché de módulos o temas.

A veces la caché de Smarty (el motor de plantillas) guarda versiones antiguas de los archivos. Solución:

1. Ve a Parámetros Avanzados > Rendimiento.
2. Haz clic en "Forzar compilación" y luego en "Limpiar caché".
3. Desactiva la "Caché de plantillas" temporalmente para pruebas.

Problema 2: Conflictos con módulos de pago o envío.

Desactiva todos los módulos de pago y envío que no sean los esenciales (por ejemplo, pago por transferencia y envío estándar). Si el carrito funciona, reactívalos uno a uno para encontrar el culpable.

Problema 3: JavaScript roto.

Abre la consola de desarrollador de tu navegador (F12 > pestaña "Consola"). Si ves errores en rojo, suele ser por:

• Un tema que carga JavaScript antiguo o incompatible.
• Un módulo que inyecta scripts defectuosos.
• Falta de la librería jQuery.

Prueba a cambiar temporalmente al tema predeterminado (por ejemplo, "classic") para descartar el tema.

Problema 4: Problemas con la sesión del cliente.

Si el carrito se vacía al cambiar de página, es un problema de sesión. Asegúrate de que:

• El dominio configurado en PrestaShop coincide exactamente con el que usas (con o sin www).
• La configuración de cookies en Parámetros de la tienda > Mantenimiento > "Configuración de cookies" es correcta. Prueba a cambiar "Dominio de cookies" a tu dominio sin www.

Error "No se puede cargar la clase" o "Class not found"

Este error suele ocurrir al instalar un módulo o tema, o al actualizar PrestaShop. Significa que el sistema no encuentra un archivo de clase necesario.

Paso 1: Verifica que el archivo existe.

La clase "NombreClase" debería estar en un archivo llamado NombreClase.php dentro de la carpeta classes/ o override/classes/. Por ejemplo, si el error dice "Class 'Cart' not found", el archivo classes/Cart.php debería existir.

Paso 2: Comprueba los overrides.

Los "overrides" (sobrescrituras) son archivos que modifican el comportamiento nativo. Si un override está mal escrito, rompe todo. Ve a la carpeta override/classes/ y renombra temporalmente todos los archivos a .php.bak. Si el error desaparece, uno de esos overrides es el problema. Investiga cuál es (normalmente el último que instalaste).

Paso 3: Limpia la caché de clases.

PrestaShop guarda un índice de clases en cache/class_index.php. Borra este archivo manualmente desde el administrador de archivos. Se regenerará automáticamente.

Paso 4: Reinstala el módulo o tema conflictivo.

Si el error apareció tras una instalación, desinstala y vuelve a instalar el módulo o tema desde el back office. Si no puedes acceder al back office, hazlo desde la base de datos:

1. En phpMyAdmin, busca la tabla ps_module.
2. Localiza el módulo problemático y anota su id_module.
3. Elimina las filas relacionadas en ps_module y ps_module_shop.
4. Borra la carpeta del módulo de /modules/.

La página de producto no se muestra correctamente (errores 404 o contenido en blanco)

Este es un problema típico después de migrar de servidor o cambiar la URL de la tienda. Se engloba dentro de los errores PrestaShop más molestos porque afecta directamente a la visibilidad de tus productos.

Causa 1: URLs amigables mal configuradas.

1. Ve a Parámetros de la tienda > Tráfico y SEO > SEO y URLs.
2. Asegúrate de que "URLs amigables" está activado.
3. Haz clic en "Configurar URLs" (o "Generar").
4. Si no funciona, desactiva las URLs amigables, guarda, y vuelve a activarlas.

Causa 2: El archivo .htaccess está corrupto o no se regenera.

PrestaShop genera un archivo .htaccess automáticamente. Si está dañado, los productos darán 404.

1. Desde el administrador de archivos de tu hosting, renombra el archivo .htaccess a .htaccess_old.
2. Ve al back office de PrestaShop a Parámetros de la tienda > Tráfico y SEO > SEO y URLs.
3. Sin cambiar nada, haz clic en "Guardar". Esto forzará la regeneración del .htaccess.

Causa 3: Faltan los enlaces permanentes (en servidores Nginx).

Si tu servidor usa Nginx en lugar de Apache, el .htaccess no sirve. Necesitas configurar las reglas de reescritura en el archivo de configuración de Nginx. Si usas Syspanel (puerto 2106), busca la sección "Dominios" > "Configuración avanzada" y añade las reglas típicas de PrestaShop para Nginx (puedes encontrarlas en la documentación oficial).

[TIP] Si después de todo sigues viendo páginas en blanco, activa el modo debug como explicamos al principio y busca errores de PHP como "Allowed memory size" o "Fatal error". La solución suele ser aumentar la memoria o desactivar módulos.

Preguntas frecuentes adicionales (FAQ PrestaShop)

Aquí tienes otras dudas habituales que recibimos en soporte.

¿Cómo recupero mi contraseña de administrador?

1. Ve a la página de login de tu back office (tudominio.com/admin1234/).
2. Haz clic en "¿Has olvidad tu contraseña?".
3. Introduce el email de administrador. Recibirás un enlace para resetearla.
4. Si no te llega el email, revisa la carpeta de spam. Si sigue sin llegar, puedes cambiar la contraseña directamente en la base de datos (phpMyAdmin) en la tabla ps_employee, campo passwd, usando una función MD5 de tu email.

Mi tienda va muy lenta, ¿qué hago?

• Activa la caché: Parámetros Avanzados > Rendimiento > Caché (recomendada: APC o Memcached si tu servidor lo soporta).
• Combina y comprime archivos CSS y JavaScript: En la misma página, activa "Combinar, comprimir y cachear archivos CSS" y "Combinar, comprimir y cachear archivos JavaScript".
• Desactiva módulos innecesarios: Cada módulo consume recursos.
• Usa un CDN: Para imágenes y archivos estáticos.

¿Cómo actualizo PrestaShop de forma segura?

1. Haz una copia de seguridad completa: Archivos y base de datos. Desde Syspanel (puerto 2106) puedes hacerlo fácilmente en la sección "Copias de seguridad".
2. Desactiva el modo mantenimiento.
3. Actualiza desde el back office: Parámetros Avanzados > Actualización.
4. Si falla, hazlo manualmente: Descarga la nueva versión, sube los archivos (sin sobrescribir /config/, /img/, /themes/, /modules/, /override/ y /upload/) y luego ejecuta el script de actualización /install/upgrade/upgrade.php.

[WARNING] Nunca actualices sin copia de seguridad. Una actualización fallida puede dejarte la tienda inservible.

Esperamos que esta FAQ PrestaShop te haya ayudado a solucionar problemas PrestaShop comunes. Recuerda que ante cualquier duda, lo mejor es tener una copia de seguridad reciente y, si el problema persiste, contactar con tu proveedor de hosting o con un desarrollador especializado. ¡Buena suerte con tu tienda!