Errores comunes en PrestaShop: Soluciones y FAQ | SysAdmin

Errores más comunes en PrestaShop y cómo solucionarlos

¿Tu tienda PrestaShop se ha quedado en blanco? ¿No puedes acceder al panel de administración? No te preocupes, son problemas más comunes de lo que crees y, por lo general, tienen una solución sencilla. En esta guía tipo FAQ, te explicamos los errores más frecuentes, por qué ocurren y cómo arreglarlos paso a paso, incluso si no eres un experto técnico.

1. Error “PrestaShop no se conecta a la base de datos”

Este es, sin duda, uno de los errores más temidos. Aparece una pantalla en blanco o un mensaje como “Cannot connect to database” o “Error de conexión a la base de datos”.

¿Por qué ocurre?
Normalmente sucede porque los datos de acceso a la base de datos han cambiado (por ejemplo, al migrar de hosting) o porque el servidor de base de datos está caído.

¿Cómo solucionarlo?

Accede a tu panel de control de hosting (por ejemplo, cPanel o Syspanel, recuerda que el acceso a Syspanel es a través del puerto 2106).
Busca el archivo app/config/parameters.php de tu PrestaShop.
Ábrelo con un editor de texto (puedes usar el administrador de archivos del hosting).
Verifica que los siguientes datos sean correctos:
- database_host: suele ser “localhost” o la IP del servidor de base de datos.
- database_name: el nombre exacto de tu base de datos.
- database_user: el usuario que tiene permisos sobre esa base.
- database_password: la contraseña de ese usuario.
Si has cambiado alguno de estos datos, corrígelos y guarda el archivo.
Vuelve a cargar tu tienda. Si el problema persiste, contacta a tu proveedor de hosting para verificar que el servicio de base de datos esté activo.

[TIP] Si no encuentras el archivo parameters.php, puede estar en /config/ en versiones antiguas de PrestaShop (1.6 o anteriores).

2. Pantalla en blanco o “Error 500” sin mensaje

Otro clásico. Abres tu tienda y solo ves una página en blanco, o un feo “Error interno del servidor (500)”.

¿Por qué ocurre?
Suele deberse a un error de PHP no mostrado, un módulo defectuoso, un tema incompatible o un límite de memoria excedido.

¿Cómo solucionarlo?

Activa el modo debug de PrestaShop para ver el error real:
- Edita el archivo config/defines.inc.php (o app/config/parameters.php en versiones 1.7+).
- Busca la línea: define('_PS_MODE_DEV_', false);
- Cámbiala a: define('_PS_MODE_DEV_', true);
- Guarda y recarga la página. Ahora deberías ver un mensaje de error específico.
Aumenta el límite de memoria PHP:
- Desde tu panel de hosting (Syspanel/cPanel), busca la opción “PHP Settings” o “Select PHP Version”.
- Aumenta memory_limit a 256M o 512M.
Desactiva módulos problemáticos:
- Si el error menciona un módulo concreto, renombra la carpeta de ese módulo en /modules/ (por ejemplo, de micodigomodulo a micodigomodulo_off).
- Vuelve a cargar la tienda. Si funciona, ya sabes qué módulo está causando el problema.
Revisa los logs del servidor:
- En Syspanel (puerto 2106), ve a “Logs” > “Error Log”. Allí verás el error exacto.

[WARNING] No olvides volver a poner _PS_MODE_DEV_ en false después de solucionar el error, o tu tienda mostrará información sensible a los visitantes.

3. Problemas con el carrito de compras (no se añaden productos)

Un error muy frustrante para tus clientes: hacen clic en “Añadir al carrito” y no pasa nada, o el carrito se vacía solo.

¿Por qué ocurre?
Casi siempre es un problema de configuración de cookies, caché o conflictos con el tema/plantilla.

¿Cómo solucionarlo?

Limpia la caché de PrestaShop:
- Ve a “Parámetros de la tienda” > “Rendimiento”.
- Haz clic en “Limpiar caché” (tanto de Smarty como de CSS/JS).
Verifica la configuración de cookies:
- En “Parámetros de la tienda” > “Configuración general” > “Cookies”.
- Asegúrate de que el “Tiempo de vida de la cookie” sea un valor razonable (por ejemplo, 480 horas).
Desactiva la opción “Forzar compilación” (si está activada):
- En “Parámetros de la tienda” > “Rendimiento”.
- Marca “No” en “Forzar compilación de plantillas”.
Prueba con un tema por defecto:
- Temporalmente, cambia a un tema nativo como “Classic” para descartar que sea un problema del diseño.

[INFO] Si el problema persiste, revisa si tienes algún módulo de seguridad o de caché (como Varnish) que esté interfiriendo con las sesiones.

4. Error “El archivo no se ha podido subir” al añadir imágenes o productos

Cuando intentas subir una imagen de producto, un logo o un banner, te aparece un mensaje de error sin más detalles.

¿Por qué ocurre?
Generalmente es por límites de tamaño de archivo en PHP o por permisos incorrectos en la carpeta de imágenes.

¿Cómo solucionarlo?

Aumenta los límites de subida en PHP:
- Desde tu panel de hosting (Syspanel o cPanel), busca “PHP Settings”.
- Aumenta upload_max_filesize y post_max_size a 20M o 50M.
Verifica los permisos de la carpeta de imágenes:
- Conéctate por FTP o usa el administrador de archivos del hosting.
- Ve a la carpeta /img/ y asegúrate de que tenga permisos 755 (o 777 si tu hosting es muy restrictivo).
- También revisa /img/p/ (para imágenes de productos) y /img/c/ (para categorías).
Comprueba el tipo de archivo:
- PrestaShop solo acepta JPG, PNG y GIF. Si intentas subir un WebP o un SVG, puede dar error.

[TIP] Si el error es intermitente, puede que tu hosting tenga un límite de tiempo de ejecución muy bajo. Aumenta max_execution_time a 300 segundos.

5. El panel de administración no carga o da error de JavaScript

Entras a /admin y ves una página a medio cargar, con botones que no funcionan o un mensaje de “algo salió mal”.

¿Por qué ocurre?
Suele ser por un conflicto con la caché de JavaScript/CSS, o por un módulo de administración defectuoso.

¿Cómo solucionarlo?

Accede al panel forzando el modo sin caché:
- Añade ?token=TU_TOKEN&disableCache=1 al final de la URL del admin (reemplaza TU_TOKEN por el token real, que puedes encontrar en el archivo config/settings.inc.php o en la base de datos).
Borra la caché manualmente:
- Conecta por FTP y borra todo el contenido de la carpeta /var/cache/ (en PrestaShop 1.7) o /cache/ (en versiones anteriores).
Desactiva la compresión de CSS/JS:
- Si logras acceder, ve a “Parámetros de la tienda” > “Rendimiento” y desmarca “Minimizar CSS” y “Minimizar JavaScript”.
Revisa la consola del navegador (F12 > Consola) para ver errores de JavaScript. A menudo indican un módulo concreto que está fallando.

[WARNING] Si no puedes acceder al admin de ninguna manera, renombra la carpeta del módulo sospechoso desde FTP (por ejemplo, /modules/mimodulo/ a /modules/mimodulo_off/). Luego intenta acceder de nuevo.

6. Error “El token de seguridad ha caducado” o “Token inválido”

Aparece al intentar guardar configuraciones o al acceder a ciertas páginas del admin.

¿Por qué ocurre?
Porque la sesión ha expirado o porque hay un problema con las cookies de seguridad.

¿Cómo solucionarlo?

Cierra sesión y vuelve a iniciar.
Limpia las cookies de tu navegador para ese dominio.
Aumenta el tiempo de vida de la sesión:
- En “Parámetros de la tienda” > “Configuración general” > “Cookies”, sube el valor de “Tiempo de vida de la cookie de sesión” a 720 horas.
Revisa la configuración de SSL:
- Si tienes HTTPS, asegúrate de que en “Parámetros de la tienda” > “Configuración general” esté marcado “Sí” en “Activar SSL” y “Activar SSL en todas las páginas”.

[INFO] Si el error aparece solo al usar un navegador específico, prueba con otro (Chrome, Firefox, Edge) para descartar problemas locales.

7. El módulo de pago no funciona o da error

Los clientes no pueden completar la compra porque el método de pago falla.

¿Por qué ocurre?
Puede ser por un certificado SSL mal configurado, una URL incorrecta en el módulo, o porque el módulo no es compatible con tu versión de PrestaShop.

¿Cómo solucionarlo?

Verifica que el SSL esté correcto:
- Entra a tu tienda con https:// y asegúrate de que el candado aparezca verde.
- Si no, contacta a tu hosting (Syspanel permite instalar certificados Let’s Encrypt de forma gratuita).
Revisa la configuración del módulo de pago:
- En el admin, ve a “Módulos” > “Módulos y servicios” y busca el módulo de pago.
- Haz clic en “Configurar” y verifica que las URLs de notificación y las claves API sean correctas.
Actualiza el módulo:
- Descarga la última versión desde el marketplace oficial o desde la web del desarrollador.
- Desinstala el módulo antiguo, sube el nuevo y vuelve a configurarlo.
Prueba con un módulo de pago por defecto (como “Pago por transferencia bancaria”) para ver si el problema es general o específico.

[WARNING] Nunca modifiques archivos del núcleo de PrestaShop para arreglar un módulo de pago. Siempre busca una actualización o un módulo alternativo.

8. Problemas de rendimiento: tienda muy lenta

Tu tienda tarda una eternidad en cargar, lo que ahuyenta a los clientes y perjudica tu SEO.

¿Por qué ocurre?
Demasiados módulos activos, imágenes sin optimizar, hosting compartido saturado o caché mal configurada.

¿Cómo solucionarlo?

Optimiza las imágenes:
- Usa herramientas como TinyPNG o el módulo “Image Optimizer” para reducir el peso de las imágenes sin perder calidad.
Activa la caché y la compresión:
- En “Parámetros de la tienda” > “Rendimiento”, activa “Caché” y elige “Sistema de archivos”.
- Marca “Minimizar CSS” y “Minimizar JavaScript”.
Desactiva módulos innecesarios:
- Revisa la lista de módulos y desinstala los que no uses.
Considera un hosting mejor:
- Si tu tienda crece, un hosting compartido puede no ser suficiente. Syspanel, por ejemplo, permite escalar fácilmente a planes VPS.

[TIP] Usa herramientas como GTmetrix o Google PageSpeed Insights para identificar exactamente qué está ralentizando tu tienda.

9. Error “No se puede escribir en la carpeta de caché” o permisos

Al instalar un módulo o actualizar PrestaShop, aparece un error de permisos.

¿Por qué ocurre?
El servidor web no tiene permisos para escribir en ciertas carpetas.

¿Cómo solucionarlo?

Conéctate por FTP o al administrador de archivos de tu hosting (Syspanel).
Ve a la raíz de PrestaShop y cambia los permisos de las siguientes carpetas a 755 (o 777 si es necesario):
- /cache/
- /log/
- /img/
- /mails/
- /modules/
- /themes/
- /translations/
- /upload/
- /download/
- /config/ (en versiones 1.6)
Si usas Syspanel, puedes hacerlo fácilmente desde la opción “Permisos de archivos”.

[INFO] Algunos hosting muy restrictivos requieren que el usuario del FTP sea el mismo que el del servidor web. Pregunta a tu proveedor si no estás seguro.

10. FAQ rápida: otras dudas comunes

¿Por qué mi PrestaShop se actualiza solo y se rompe?
Las actualizaciones automáticas desde el backoffice pueden fallar si hay módulos incompatibles. Siempre haz una copia de seguridad antes de actualizar.

¿Cómo recupero mi tienda si no tengo acceso al admin?
Puedes desactivar módulos problemáticos renombrando sus carpetas desde FTP, o restaurar una copia de seguridad de la base de datos desde Syspanel.

¿Qué hago si el error es de “Límite de memoria excedido”?
Aumenta memory_limit en la configuración de PHP de tu hosting. Si no puedes, contacta a soporte.

Mi tienda muestra “PrestaShop no puede cargar el módulo X”
El módulo está corrupto o falta un archivo. Reinstálalo desde el marketplace o elimínalo si no es esencial.

Conclusión

Los errores en PrestaShop pueden ser frustrantes, pero la mayoría tienen una solución clara y documentada. Recuerda siempre:

Hacer copias de seguridad antes de hacer cambios importantes.
Mantener todo actualizado (PrestaShop, módulos, temas, PHP).
Usar un hosting de calidad (como Syspanel, con soporte optimizado para PrestaShop).

Si después de seguir estos pasos el problema persiste, no dudes en contactar a tu proveedor de hosting o a un desarrollador especializado. ¡Tu tienda online volverá a funcionar en poco tiempo!