🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Cómo solucionar errores comunes en PrestaShop: Guía básica

Actualizado el 18 de mayo de 2026

¡Hola! Si estás leyendo esto, es muy probable que tu tienda PrestaShop no esté funcionando como debería. No te preocupes, es más común de lo que crees. Como técnico de soporte, te guiaré paso a paso para que puedas identificar y solucionar los errores PrestaShop comunes por ti mismo, sin necesidad de ser un experto en programación. Esta guía está diseñada para que, incluso si tu conocimiento técnico es básico, puedas solucionar problemas PrestaShop con confianza.

Empecemos con lo más importante: mantener la calma. La mayoría de los fallos tienen una solución sencilla. Vamos a dividir esta guía en los problemas más frecuentes que afectan a las tiendas online.

1. La temida pantalla en blanco (Página en blanco o Error 500)

Este es, sin duda, uno de los fallos PrestaShop más frustrantes. De repente, tu tienda deja de cargar y solo ves una página en blanco. Esto suele deberse a un error interno del servidor o a un conflicto con un módulo o tema.

¿Por qué ocurre?

  • Límite de memoria PHP excedido: Tu servidor no tiene suficiente memoria para ejecutar las tareas de PrestaShop.
  • Módulo o tema defectuoso: Una actualización reciente o una mala configuración puede romper la tienda.
  • Archivo .htaccess corrupto: Este archivo es clave para las URL amigables y la seguridad.
  • Error en el archivo settings.inc.php: Contiene la configuración de la base de datos.

Solución paso a paso

Sigue estos pasos en orden, del más simple al más complejo.

  1. Activa el modo debug de PrestaShop. Esto te mostrará el error real en lugar de la pantalla en blanco.

    • Accede a tu panel de control de hosting (por ejemplo, cPanel o Syspanel – recuerda que para acceder a Syspanel debes usar el puerto 2106).
    • Busca el administrador de archivos (File Manager) o usa un cliente FTP (como FileZilla).
    • Navega hasta la carpeta raíz de tu tienda (donde están las carpetas admin, modules, themes, etc.).
    • Busca el archivo config/defines.inc.php.
    • Ábrelo con un editor de texto (como el Bloc de notas o Sublime Text).
    • Busca la línea: define('_PS_MODE_DEV_', false);
    • Cámbiala por: define('_PS_MODE_DEV_', true);
    • Guarda el archivo y recarga tu tienda. Ahora, en lugar de la pantalla en blanco, verás un mensaje de error específico. ¡Anota ese mensaje!

  2. Aumenta el límite de memoria PHP. Es la causa más común.

    • Vuelve al administrador de archivos de tu hosting.
    • Busca un archivo llamado php.ini en la raíz de tu tienda. Si no existe, créalo.
    • Si usas Syspanel, puedes encontrar esta opción en "Ajustes PHP" dentro del panel de tu dominio.
    • Añade o modifica esta línea: memory_limit = 256M
    • También puedes añadir: max_execution_time = 120 (para dar más tiempo a procesos largos).
    • Guarda el archivo. Si no funciona, prueba con memory_limit = 512M.

  3. Desactiva módulos y temas desde la base de datos. Si el error persiste, es probable que un módulo esté causando el problema. Como no puedes acceder al panel de administración, lo haremos desde la base de datos.

    • Accede a phpMyAdmin desde tu panel de hosting (cPanel o Syspanel).
    • Selecciona la base de datos de tu tienda.
    • Busca la tabla ps_modules (el prefijo ps_ puede variar).
    • Haz clic en "Examinar" (o "Browse").
    • Verás una lista de todos los módulos. Para desactivarlos todos, haz clic en "SQL" (o "Consulta") y ejecuta este comando: UPDATE ps_modules SET active = 0;
    • ¡Cuidado! Esto desactivará todos los módulos. Luego, desde el panel de administración, podrás reactivarlos uno por uno para encontrar el culpable.
    • Para restaurar el tema por defecto, busca la tabla ps_configuration y ejecuta: UPDATE ps_configuration SET value = 'default' WHERE name = 'PS_CATALOG_MODE'; (Ajusta 'default' por el nombre de tu tema original).

  4. Regenera el archivo .htaccess. Un archivo .htaccess dañado es otro culpable frecuente.

    • Conéctate por FTP o usa el administrador de archivos.
    • Busca el archivo .htaccess en la raíz.
    • Renómbralo a .htaccess_old (esto lo desactiva).
    • Ahora, intenta acceder a tu tienda. Si funciona, el problema era ese archivo.
    • Ve al panel de administración de PrestaShop > Preferencias > SEO y URLs > y haz clic en "Guardar" (sin cambiar nada). Esto regenerará el archivo .htaccess automáticamente.

[INFO] Si después de activar el modo debug ves un error como "Fatal error: Allowed memory size of...", el paso 2 es tu solución.

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

Verás un mensaje como "Error de conexión a la base de datos" o "Cannot connect to database". Esto significa que PrestaShop no puede comunicarse con la base de datos donde se almacenan tus productos, clientes y pedidos.

Causas comunes

  • Credenciales incorrectas: La contraseña o el usuario de la base de datos han cambiado.
  • Servidor de base de datos caído: El servicio MySQL o MariaDB no se está ejecutando.
  • Archivo settings.inc.php corrupto o mal configurado.

Solución

  1. Verifica el estado del servicio de base de datos. Desde tu panel de hosting (Syspanel o cPanel), busca la sección de "Servicios" o "MySQL". Asegúrate de que el servicio esté "Running" (en ejecución). Si está detenido, inícialo.

  2. Revisa el archivo de configuración.

    • Ve al administrador de archivos y abre config/settings.inc.php.
    • Busca estas líneas: 
      define('_DB_SERVER_', 'localhost'); // O la dirección del servidor
define('_DB_NAME_', 'nombre_de_tu_bd');
define('_DB_USER_', 'usuario_de_tu_bd');
define('_DB_PASSWD_', 'contraseña_de_tu_bd');
    • Compara estos datos con los de tu base de datos. Puedes encontrar las credenciales correctas en el panel de tu hosting, en la sección "Bases de datos MySQL".
    • Si la contraseña tiene caracteres especiales (como $, %, #), puede que necesites escaparlos. Una solución simple es cambiarla desde phpMyAdmin por una contraseña alfanumérica simple (ej: MiT1enda2023) y actualizarla en el archivo.

[WARNING] Nunca compartas tus credenciales de base de datos. Si sospechas que han sido comprometidas, cámbialas inmediatamente desde tu panel de hosting.

3. Error "Página no encontrada" o "404" en todas las páginas

Este error suele aparecer después de migrar tu tienda a un nuevo servidor o cambiar la URL. Las URL amigables se han roto.

Solución

  1. Regenera el archivo .htaccess (como en el punto 1.4). Este paso suele resolver el 90% de los casos.

  2. Desactiva y reactiva las URL amigables.

    • Si puedes acceder al panel de administración, ve a Preferencias > SEO y URLs.
    • Desmarca la opción "Usar URL amigables" y guarda.
    • Vuelve a marcarla y guarda de nuevo.

  3. Verifica la configuración del servidor. A veces, el servidor no tiene habilitado el módulo mod_rewrite de Apache.

    • Si usas Syspanel, puedes verificar esto en "Ajustes PHP" o contactar con el soporte técnico.
    • Si tienes acceso a la terminal, puedes ejecutar sudo a2enmod rewrite y luego reiniciar Apache.

4. El carrito no funciona o no se añaden productos

Este es uno de los errores PrestaShop comunes que más quejas genera. El cliente hace clic en "Añadir al carrito" y no pasa nada, o el carrito se vacía solo.

Causas y soluciones

  • Problema con las cookies: PrestaShop usa cookies para recordar el carrito.

    • Solución: Pide a tus clientes que borren las cookies de su navegador. Tú, como administrador, puedes probar en modo incógnito.

  • Conflicto con el tema o módulo de carrito: Un tema personalizado o un módulo de carrito avanzado puede estar mal programado.

    • Solución: Cambia temporalmente al tema por defecto (por ejemplo, "classic") para ver si el problema persiste. Si se soluciona, el error está en tu tema.

  • JavaScript bloqueado: Algunos módulos de seguridad o cache pueden bloquear el JavaScript necesario para el carrito.

    • Solución: Desactiva los módulos de cache (como "Page Cache" o "Varnish") uno por uno para identificar al culpable.

  • Problemas con la sesión de PHP: Las sesiones permiten que PrestaShop recuerde al usuario.

    • Solución: Aumenta el límite de sesión en el archivo php.ini: session.gc_maxlifetime = 86400 (24 horas).

[TIP] Para diagnosticar problemas de carrito, activa el modo debug (como en el punto 1) y abre la consola de JavaScript de tu navegador (F12 > Consola). Los errores en rojo te darán pistas sobre qué está fallando.

5. Problemas con el envío de correos electrónicos (Olvido de contraseña, confirmación de pedido)

Los correos no llegan a tus clientes o a ti. Esto puede deberse a una mala configuración del servidor SMTP o a que tu hosting bloquea el envío masivo.

Solución

  1. Usa un servidor SMTP externo (recomendado). No uses la función mail() de PHP, ya que muchos hostings la limitan.

    • Ve a tu panel de administración de PrestaShop > Parámetros Avanzados > Parámetros de Email.
    • Selecciona "Usar mis propios parámetros SMTP".
    • Configúralo con los datos de tu proveedor de correo (Gmail, Outlook, o un servicio transaccional como SendGrid, Mailgun, etc.).
    • Ejemplo para Gmail: Servidor: smtp.gmail.com, Puerto: 587, Protocolo: TLS, Autenticación: Sí, Usuario: tucorreo@gmail.com, Contraseña: tucontraseña (o una contraseña de aplicación).

  2. Prueba el envío. En la misma página, hay un botón "Enviar un email de prueba". Introduce tu correo y haz clic. Si te llega, el problema está solucionado.

  3. Revisa la carpeta de Spam. A veces los correos llegan allí. Pide a tus clientes que te marquen como "No es spam".

6. Error al actualizar PrestaShop o un módulo

Las actualizaciones son vitales para la seguridad, pero a veces fallan y dejan la tienda en un estado inconsistente.

Prevención (antes de actualizar)

  • Siempre haz una copia de seguridad. Esta es la regla de oro. Copia todos los archivos y exporta la base de datos desde phpMyAdmin.
  • Actualiza en un entorno de pruebas (si es posible) antes de hacerlo en producción.

Solución si la actualización falla

  1. Activa el modo debug para ver el error exacto.

  2. Revisa los requisitos del sistema. La nueva versión de PrestaShop puede requerir una versión más reciente de PHP. Si tu hosting no la soporta, la actualización fallará.

    • En Syspanel, puedes cambiar la versión de PHP en "Ajustes PHP" > "Versión de PHP". Selecciona la recomendada por PrestaShop (generalmente 7.4, 8.0 o 8.1).

  3. Restaura la copia de seguridad. Si todo falla, esta es tu red de seguridad. Sube los archivos de la copia de seguridad por FTP e importa la base de datos desde phpMyAdmin (usando la opción "Importar").

[WARNING] No interrumpas nunca una actualización a mitad de proceso. Puede dejar tu base de datos en un estado irrecuperable. Si se queda colgada más de 10 minutos, contacta con el soporte técnico de tu hosting.

Preguntas Frecuentes (FAQ) sobre errores PrestaShop

¿Por qué mi PrestaShop va muy lento?

Puede deberse a un hosting compartido con recursos limitados, a la falta de un sistema de cache (como el cache de Smarty o Varnish), a imágenes sin optimizar, o a módulos mal programados. Te recomiendo:

  • Activar la cache de Smarty en Parámetros Avanzados > Rendimiento.
  • Optimizar tus imágenes (tamaño máximo 100-200 KB).
  • Contratar un hosting especializado en PrestaShop.

¿Cómo puedo recuperar mi tienda si no tengo acceso al panel de administración?

Sigue los pasos del punto 1 (pantalla en blanco). Si puedes acceder al hosting vía FTP o Syspanel, puedes desactivar módulos desde la base de datos (paso 1.3) o restaurar una copia de seguridad. Si no tienes copia, contacta con tu proveedor de hosting.

¿Qué debo hacer si veo un error de "500 Internal Server Error"?

Es un error genérico. Activa el modo debug (punto 1.1) para ver el mensaje real. Las causas más comunes son: límite de memoria, archivo .htaccess corrupto o un módulo roto.

¿Es seguro desactivar todos los módulos desde la base de datos?

Sí, es seguro. Es una técnica de diagnóstico. Luego puedes reactivarlos desde el panel de administración. Eso sí, asegúrate de anotar los nombres de los módulos que tenías activos antes de desactivarlos.

¿Cada cuánto debo hacer una copia de seguridad?

Idealmente, cada vez que hagas un cambio importante (actualizar un módulo, cambiar el tema, añadir muchos productos). Como mínimo, una vez a la semana. Muchos hostings ofrecen copias de seguridad automáticas.

Conclusión

Solucionar errores PrestaShop comunes no tiene por qué ser una pesadilla. Con esta guía básica, ya tienes las herramientas para enfrentarte a los problemas más habituales: pantalla en blanco, errores de base de datos, carritos rotos y problemas de correo.

Recuerda que la clave está en la paciencia y en seguir los pasos de forma ordenada. Siempre empieza por lo más sencillo (activar el modo debug, regenerar el .htaccess) y ve subiendo en complejidad. Y, sobre todo, nunca subestimes el poder de una buena copia de seguridad.

Si después de intentarlo todo el problema persiste, no dudes en contactar con el soporte técnico de tu hosting. Diles que ya has seguido estos pasos; te lo agradecerán y te ayudarán más rápido.

¡Espero que tu tienda vuelva a funcionar a la perfección! Si te ha sido útil, comparte esta guía con otros comerciantes. ¡Buena suerte!

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel