Errores comunes en PrestaShop y cómo solucionarlos | FAQ

Montar una tienda online con PrestaShop es un paso emocionante, pero a veces surgen pequeños contratiempos que pueden frenar el proceso. Que aparezcan errores PrestaShop no significa que hayas hecho algo mal; simplemente son parte del camino. Aquí te guiamos paso a paso para solucionar problemas PrestaShop, desde los fallos más típicos de instalación hasta problemas de rendimiento. Al final de esta guía, también encontrarás una sección FAQ PrestaShop con las dudas más frecuentes.

1. Errores durante la instalación inicial

La instalación de PrestaShop suele ser sencilla, pero hay algunos puntos donde muchos usuarios se quedan atascados.

1.1. El asistente de instalación no avanza o se queda en blanco

Si al ejecutar el instalador ves una pantalla en blanco o el proceso se detiene sin razón aparente, lo más probable es que tu servidor no cumpla con los requisitos mínimos de PHP.

Solución paso a paso:

Verifica la versión de PHP: PrestaShop 8 necesita PHP 7.4 o superior. Si usas un panel de control como Syspanel (accediendo por el puerto 2106), busca la sección "PHP Settings" y cambia la versión a 8.0 o 8.1.
Aumenta el límite de memoria: Busca el parámetro memory_limit en la configuración de PHP. Debe ser al menos 256M. Si no lo ves, puedes crearlo con ese valor.
Habilita las extensiones necesarias: PrestaShop requiere extensiones como curl, gd, json, mbstring, openssl, pdo_mysql, zip y xml. En Syspanel, suelen venir activadas por defecto, pero revísalo en la sección "PHP Extensions".

[INFO] Si estás en un hosting compartido, contacta con el soporte técnico de tu proveedor. Ellos pueden ajustar estos valores por ti.

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

Este es uno de los errores PrestaShop más comunes. El instalador no puede conectar con MySQL o MariaDB.

Solución:

Crea la base de datos manualmente: No confíes en que el instalador la cree solo. Ve a Syspanel (puerto 2106), entra en "Databases" y crea una nueva base de datos y un usuario con todos los privilegios.
Datos correctos: Asegúrate de copiar exactamente el nombre de la base de datos, el usuario y la contraseña. Los nombres suelen tener un prefijo (ej: usuario_mitienda).
Prueba la conexión: Si el instalador te da error, usa un cliente como phpMyAdmin (desde Syspanel) para verificar que los datos funcionan. Si phpMyAdmin tampoco conecta, el problema es del servidor, no de PrestaShop.

1.3. El instalador no encuentra la carpeta de archivos

Al subir PrestaShop por FTP, a veces la carpeta principal se descomprime dentro de otra carpeta (ej: public_html/prestashop/prestashop/). El instalador no sabe dónde buscar.

Solución:

Revisa la estructura de carpetas: Conéctate por FTP o al administrador de archivos de Syspanel. Busca una carpeta que contenga el archivo index.php y la carpeta install.
Mueve todo al directorio raíz: Corta todo el contenido de la carpeta interna (donde está index.php) y pégalo directamente en public_html o www. Luego elimina las carpetas vacías sobrantes.
Vuelve a intentar la instalación: Ahora la URL de tu tienda apuntará directamente al instalador.

2. Problemas de configuración y personalización

Una vez instalada, la tienda puede mostrar errores raros o no funcionar como esperas.

2.1. Página de inicio en blanco (White Screen of Death)

Esto suele pasar por un módulo incompatible, un error de PHP o un tema mal configurado.

Solución:

Activa el modo debug: Edita el archivo config/defines.inc.php (por FTP o desde el editor de archivos de Syspanel). Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Guarda y recarga la página. Ahora verás el mensaje de error real.
Desactiva módulos manualmente: Si el error menciona un módulo, renombra la carpeta del módulo en /modules/ (ej: modulo_problema a modulo_problema_off). Esto lo desactivará.
Cambia al tema predeterminado: Si el error viene del tema, renombra la carpeta del tema en /themes/ a otro nombre. PrestaShop usará el tema Classic por defecto.

[WARNING] No olvides desactivar el modo debug cuando termines. Si lo dejas activo, cualquier visitante podrá ver errores internos de tu servidor.

2.2. Error de token de seguridad al guardar productos o configuraciones

Al editar un producto o una configuración, te sale un mensaje de "token inválido" o "error de seguridad".

Solución:

Limpia la caché de PrestaShop: Ve a "Parámetros Avanzados" > "Rendimiento" y haz clic en "Limpiar caché". A veces los tokens caducan.
Cierra sesión y vuelve a iniciar: Un token se genera al iniciar sesión. Si tienes la sesión abierta desde hace horas, puede haber caducado.
Revisa la configuración de la URL: Ve a "Parámetros de la tienda" > "Tráfico y SEO". Asegúrate de que la URL base (tu dominio) está bien escrita, sin www o con www, según lo que uses. Si la cambiaste recientemente, guarda de nuevo.

2.3. Las imágenes no se cargan o aparecen rotas

Las imágenes de productos, categorías o logotipos no se ven.

Solución:

Regenera las miniaturas: Ve a "Parámetros Avanzados" > "Imágenes". Haz clic en "Regenerar miniaturas". Espera a que termine el proceso (puede tardar).
Verifica los permisos de carpetas: Las carpetas /img/ y /upload/ deben tener permisos 755. En Syspanel, puedes cambiar los permisos desde el administrador de archivos.
Comprueba el tamaño máximo de subida: Si no puedes subir imágenes, el límite de PHP (upload_max_filesize) puede ser muy bajo. En Syspanel, ajústalo a 20M o más.

3. Errores de rendimiento y caché

Una tienda lenta ahuyenta a los clientes. Estos son los problemas más frecuentes.

3.1. La tienda carga muy lento o se cae

Solución:

Activa la caché: Ve a "Parámetros Avanzados" > "Rendimiento". Activa la "Caché" y elige "Sistema de archivos" o "Memcache" si tu servidor lo soporta.
Combina y comprime archivos: En la misma sección, activa "Combinar, comprimir y cachear archivos JavaScript" y "Combinar, comprimir y cachear archivos CSS". Esto reduce las peticiones al servidor.
Revisa los módulos activos: Desactiva módulos que no uses. Cada módulo activo consume recursos. Ve a "Módulos" > "Gestor de módulos" y desinstala los que no necesites.
Actualiza PHP: Si tu servidor usa PHP 7.4, actualiza a 8.0 o 8.1. En Syspanel, es un clic. El rendimiento mejora notablemente.

3.2. Error 500 o 503 en páginas de producto o categoría

Estos errores suelen aparecer cuando hay un conflicto entre módulos o un problema de memoria.

Solución:

Aumenta el límite de memoria PHP: Como vimos antes, sube memory_limit a 256M o 512M.
Desactiva módulos de terceros: Si el error solo aparece en una categoría con muchos productos, prueba desactivando módulos de filtros, búsqueda avanzada o SEO.
Revisa el log de errores del servidor: En Syspanel, busca "Logs" o "Error logs". Allí verás el error exacto (ej: "Allowed memory size exhausted"). Eso te dará la pista definitiva.

4. Problemas con el carrito y los pedidos

El proceso de compra es crítico. Cualquier error aquí puede hacer perder ventas.

4.1. El carrito se vacía solo o no guarda productos

Solución:

Revisa la configuración de cookies: Ve a "Parámetros de la tienda" > "Configuración general". Asegúrate de que "Activar cookies" está en "Sí".
Comprueba la configuración de la URL canónica: Si tienes la tienda en midominio.com y el carrito redirige a www.midominio.com, las cookies no se comparten. En "Tráfico y SEO", elige una opción (con o sin www) y redirige siempre a esa URL.
Actualiza el módulo de carrito: A veces el módulo "Carrito" está desactualizado. Ve a "Módulos" y busca "Carrito". Si hay actualización, aplícala.

4.2. Error al procesar el pago (gateway no responde)

Solución:

Verifica las claves API: Si usas PayPal, Stripe u otro, asegúrate de que las claves de producción (no las de pruebas) están bien copiadas.
Comprueba la versión de TLS: Muchos bancos exigen TLS 1.2 o superior. En la configuración del módulo de pago, busca la opción "Versión TLS" y elige la más alta disponible.
Prueba en modo sandbox: Activa el modo de pruebas del módulo de pago. Si funciona, el problema está en la configuración de las claves reales.

5. FAQ PrestaShop: Preguntas frecuentes

Aquí respondemos las dudas más comunes que recibimos en soporte técnico.

5.1. ¿Cómo recupero mi tienda si veo un error blanco después de instalar un módulo?

Respuesta: Accede por FTP o al administrador de archivos de Syspanel (puerto 2106). Ve a la carpeta /modules/ y localiza la carpeta del módulo que instalaste justo antes del error. Renómbrala (ej: añade "_off" al final). La tienda volverá a funcionar. Luego, desde el back office, desinstala el módulo.

5.2. No puedo acceder al back office. La URL me redirige al front office.

Respuesta: Esto pasa cuando la configuración de URL está mal. Edita el archivo config/settings.inc.php. Busca la línea que empieza por define('_PS_BASE_URL_',.... Cámbiala por tu dominio correcto (sin barra al final). Guarda y prueba de nuevo.

5.3. ¿Por qué mis productos no aparecen en Google aunque ya los indexé?

Respuesta: Puede ser por falta de un sitemap. Ve a "Módulos" > "Gestor de módulos" e instala el módulo "Google Sitemap" (oficial de PrestaShop). Genéralo y envíalo a Google Search Console. También revisa que la opción "Indexación" en cada producto esté en "Sí".

5.4. El instalador me pide que elimine la carpeta "install". ¿Cómo lo hago?

Respuesta: Conéctate por FTP o al administrador de archivos de Syspanel. Localiza la carpeta install en la raíz de tu tienda. Selecciónala y haz clic en "Eliminar". Si no puedes, renómbrala a install_old y luego elimínala. Nunca dejes la carpeta install, es un riesgo de seguridad.

5.5. Mi tienda está en varios idiomas, pero los textos de los módulos no se traducen.

Respuesta: Ve a "Internacional" > "Traducciones". En "Modificar traducciones", elige "Traducciones de módulos instalados", selecciona tu idioma y el módulo. Traduce los textos que faltan. Luego, limpia la caché.

5.6. ¿Cómo aumento el límite de subida de archivos en Syspanel?

Respuesta: Inicia sesión en Syspanel (puerto 2106). Ve a "PHP Settings" y busca "upload_max_filesize". Cámbialo a "20M" o "50M". Guarda los cambios. Si no ves la opción, contacta con tu proveedor de hosting.

[TIP] La mayoría de estos errores PrestaShop se solucionan con paciencia y siguiendo los pasos en orden. Si te sientes perdido, siempre puedes consultar la documentación oficial o abrir un ticket de soporte con tu hosting.

Con esta guía, ya tienes las herramientas para solucionar problemas PrestaShop y mantener tu tienda funcionando sin sobresaltos. Recuerda: cada error es una oportunidad para aprender más sobre tu tienda. ¡Ánimo con tu proyecto!