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

Solucionar errores comunes en PrestaShop: guía FAQ

Actualizado el 24 de febrero de 2026

¿Tu tienda PrestaShop ha comenzado a dar errores y no sabes por dónde empezar? No te preocupes, es más común de lo que crees. Esta guía FAQ está diseñada para ayudarte a resolver los problemas más frecuentes sin necesidad de ser un experto en programación. Aquí encontrarás soluciones paso a paso para los errores PrestaShop más típicos, desde problemas de base de datos hasta conflictos con módulos.

¿Por qué aparecen los errores en PrestaShop?

Los errores en PrestaShop suelen deberse a tres causas principales: una mala configuración del servidor, incompatibilidades entre módulos o una base de datos corrupta. A menudo, el problema aparece después de una actualización, al instalar un nuevo tema o al modificar archivos sin cuidado.

[INFO] La mayoría de los errores tienen solución y no implican perder datos de tu tienda. Siempre haz una copia de seguridad antes de hacer cambios importantes.

Errores de base de datos: los más comunes

Error "Cannot connect to database" o "Error de conexión a la base de datos"

Este es uno de los errores PrestaShop más alarmantes, pero casi siempre se soluciona revisando la configuración.

Causas posibles:

  • Contraseña de la base de datos incorrecta.
  • El servidor de base de datos (MySQL/MariaDB) está caído.
  • El nombre de la base de datos ha cambiado.

Solución paso a paso:

  1. Accede a tu panel de control de hosting (por ejemplo, cPanel o Syspanel en puerto 2106).
  2. Busca la sección de "Bases de datos MySQL".
  3. Verifica que el usuario y la contraseña que usas en PrestaShop coincidan exactamente con los de la base de datos.
  4. Abre el archivo app/config/parameters.php en la raíz de tu instalación de PrestaShop.
  5. Busca las líneas database_name, database_user y database_password y compáralas con los datos reales.
  6. Si hay diferencias, corrígelas y guarda el archivo.
  7. Si usas Syspanel, reinicia el servicio de MySQL desde el panel.

[WARNING] No compartas nunca tu contraseña de base de datos en foros públicos. Si sospechas que está comprometida, cámbiala desde el panel de hosting.

Error "Table not found" o "La tabla no existe"

Este error suele aparecer después de una actualización fallida o al restaurar una copia de seguridad incompleta.

Solución:

  1. Accede a phpMyAdmin desde tu panel de hosting.
  2. Selecciona la base de datos de tu tienda.
  3. En la pestaña "SQL", ejecuta el siguiente comando (reemplaza nombre_tabla por el nombre que aparece en el error): 
    REPAIR TABLE nombre_tabla;
  4. Si la tabla no se repara, puede que falte. En ese caso, deberás restaurar una copia de seguridad reciente.
  5. Si no tienes copia, puedes intentar crear la tabla manualmente desde el instalador de PrestaShop o contactar con soporte técnico.

Problemas con módulos: cómo identificarlos y solucionarlos

Error "Módulo incompatible" o "Module not compatible"

Los módulos son una de las principales fuentes de errores PrestaShop. Un módulo desactualizado puede romper toda la tienda.

Cómo diagnosticar:

  1. Ve a "Módulos" > "Gestor de módulos" en el back office.
  2. Busca módulos con un icono de advertencia (triángulo amarillo).
  3. Haz clic en "Actualizar" si hay una versión disponible.
  4. Si el módulo no se actualiza, desactívalo temporalmente para ver si el error desaparece.

Solución:

  • Actualiza el módulo: Siempre que sea posible, actualiza a la última versión compatible con tu PrestaShop.
  • Desinstala y reinstala: Si la actualización no funciona, desinstala el módulo, limpia la caché y vuelve a instalarlo.
  • Contacta al desarrollador: Algunos módulos requieren pago o soporte específico.

[TIP] Antes de instalar un módulo nuevo, verifica que sea compatible con tu versión de PrestaShop (1.6, 1.7 o 8.x). Puedes consultarlo en la ficha del módulo en el marketplace.

Error "500 Internal Server Error" al activar un módulo

Este error es muy común y suele deberse a un conflicto de PHP o a un error en el código del módulo.

Solución:

  1. Accede a tu servidor por FTP o al administrador de archivos de Syspanel.
  2. Ve a la carpeta /modules/nombre_del_modulo/.
  3. Renombra la carpeta del módulo añadiendo "_old" al final (por ejemplo, moduloproblema_old). Esto desactivará el módulo.
  4. Vuelve a cargar tu tienda. El error debería desaparecer.
  5. Si la tienda funciona, puedes eliminar el módulo desde el back office o reinstalarlo correctamente.

Si no sabes qué módulo causa el error:

  • Revisa el archivo de logs de errores de PHP. En Syspanel, puedes acceder a los logs desde "Registros del sistema".
  • Busca líneas que contengan "PHP Fatal error" y el nombre del módulo.

Errores de caché y rendimiento

Error "Página en blanco" o "White screen of death"

Una página en blanco suele indicar un error de PHP que no se muestra por tener la visualización de errores desactivada.

Solución:

  1. Accede al archivo config/defines.inc.php en la raíz de PrestaShop.
  2. Busca la línea define('_PS_MODE_DEV_', false); y cámbiala a: 
    define('_PS_MODE_DEV_', true);
  3. Guarda el archivo y recarga la tienda. Ahora verás el mensaje de error detallado.
  4. Anota el error (por ejemplo, "Call to undefined function" o "Allowed memory size exhausted").
  5. Una vez solucionado, vuelve a poner false para evitar mostrar errores a los clientes.

Errores comunes que verás:

  • "Allowed memory size exhausted": Aumenta el límite de memoria PHP en tu panel de hosting (recomendado: 256M o más).
  • "Call to undefined function": Indica que falta una extensión de PHP (por ejemplo, curl o gd). Actívala desde Syspanel.

Error "La caché no se limpia" o "Cambios no se reflejan"

PrestaShop guarda caché para acelerar la tienda, pero a veces se queda obsoleta.

Solución:

  1. En el back office, ve a "Parámetros de la tienda" > "Rendimiento".
  2. Haz clic en "Limpiar caché" (botón verde).
  3. Si eso no funciona, borra manualmente la carpeta /var/cache/ desde FTP.
  4. También puedes desactivar la caché temporalmente mientras haces pruebas.

Errores de actualización de PrestaShop

Error "1.7.x no se actualiza" o "Error durante la migración"

Actualizar PrestaShop puede ser delicado. Los errores más comunes son por falta de espacio en el servidor o incompatibilidad de PHP.

Requisitos previos:

  • PHP 7.4 o superior (recomendado PHP 8.1 para PrestaShop 8.x).
  • Memoria PHP de al menos 256 MB.
  • Espacio en disco suficiente (mínimo 1 GB libre).

Solución paso a paso:

  1. Haz una copia de seguridad completa (archivos y base de datos).
  2. Desde tu panel de hosting (Syspanel), verifica que la versión de PHP sea compatible.
  3. Si usas Syspanel, ve a "PHP Selector" y elige la versión adecuada.
  4. Desactiva todos los módulos de terceros antes de la actualización.
  5. Usa el módulo "1-Click Upgrade" de PrestaShop para la actualización.
  6. Si el proceso se detiene, revisa los logs de error en /var/log/ del servidor.

[WARNING] Nunca actualices directamente desde la versión 1.6 a la 8.x. Debes hacerlo de forma progresiva (1.6 -> 1.7 -> 8.x) o usar una migración manual.

Preguntas frecuentes (FAQ) sobre errores PrestaShop

¿Qué hago si mi tienda no carga después de instalar un tema?

  1. Accede al back office usando la URL directa: tudominio.com/admin1234 (sustituye "admin1234" por tu carpeta real).
  2. Ve a "Diseño" > "Temas" y selecciona el tema predeterminado (por ejemplo, "Classic").
  3. Si no puedes acceder al back office, renombra la carpeta del tema desde FTP: /themes/nuevotema/ a /themes/nuevotema_old/. PrestaShop cargará el tema por defecto.

¿Por qué aparecen caracteres extraños o "??" en mi tienda?

Esto suele ser un problema de codificación de la base de datos.

Solución:

  1. En phpMyAdmin, selecciona tu base de datos.
  2. Ve a "Operaciones" y cambia el cotejamiento (collation) a utf8_general_ci.
  3. También puedes ejecutar: 
    ALTER DATABASE nombre_base_datos CHARACTER SET utf8 COLLATE utf8_general_ci;

¿Cómo soluciono el error "PrestaShop no puede conectar con el servicio de módulos"?

Este error aparece cuando el servidor no puede acceder a los servidores de Addons de PrestaShop.

Causas:

  • Firewall bloqueando la conexión.
  • DNS mal configurado.
  • Falta la extensión cURL en PHP.

Solución:

  1. Verifica que cURL esté activado desde tu panel de hosting.
  2. Si usas Syspanel, ve a "PHP Extensiones" y activa curl.
  3. Comprueba que tu servidor pueda hacer peticiones externas. Puedes probar con: 
    curl -I https://addons.prestashop.com
    (desde SSH o terminal).
  4. Si el problema persiste, contacta con tu proveedor de hosting.

Consejos finales para prevenir errores

Para minimizar los errores PrestaShop, sigue estas buenas prácticas:

  • Actualiza regularmente: Tanto PrestaShop como los módulos y el tema.
  • Usa un hosting específico para PrestaShop: Que ofrezca PHP optimizado y suficiente memoria.
  • Haz copias de seguridad semanales: Incluyendo archivos y base de datos.
  • Prueba en un entorno de desarrollo: Antes de aplicar cambios en producción.
  • Lee los logs: Revisa periódicamente los logs de error de PHP y de PrestaShop.

[TIP] Si usas Syspanel (puerto 2106), puedes programar copias de seguridad automáticas desde la sección "Backups". Así siempre tendrás un punto de restauración.

Recuerda que la paciencia y el método son clave. La mayoría de los errores PrestaShop tienen solución documentada. Si después de seguir esta guía el problema persiste, no dudes en buscar en foros especializados o contactar con un desarrollador. ¡Tu tienda volverá a funcionar!

¿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