Errores comunes en PrestaShop y cómo solucionarlos

¿Por qué aparece una página en blanco en PrestaShop?

La temida página en blanco es, probablemente, el problema más común entre quienes usan PrestaShop. Un día todo funciona y, al siguiente, ves una pantalla completamente blanca. No te asustes: en la mayoría de los casos, la solución es más sencilla de lo que parece.

Este error suele deberse a un límite de memoria PHP excedido, a un módulo incompatible o a un archivo corrupto. La buena noticia es que puedes diagnosticarlo paso a paso sin necesidad de ser un experto en programación.

Primer paso: activa el modo debug de PrestaShop

PrestaShop oculta los errores por defecto, mostrándote solo la pantalla blanca. Para ver qué está fallando, debes activar el modo de depuración:

Accede a tu hosting mediante FTP o al administrador de archivos de tu panel de control.
Localiza el archivo config/defines.inc.php en la raíz de tu instalación.
Busca la línea que dice define('_PS_MODE_DEV_', false);
Cambia false por true.
Guarda el archivo y recarga tu tienda.

Ahora verás el error real en pantalla, como un mensaje de memoria o un archivo específico que falla. Anota ese mensaje, porque te ayudará a aplicar la solución correcta.

[TIP] Después de resolver el problema, vuelve a poner _PS_MODE_DEV_ en false para no exponer información sensible a tus visitantes.

Solución rápida para la página en blanco

Si no quieres investigar demasiado, prueba esto directamente:

Aumenta el límite de memoria PHP a 256 MB o 512 MB. Puedes hacerlo desde el archivo .htaccess añadiendo: php_value memory_limit 512M
Desactiva todos los módulos no esenciales desde la base de datos o renombrando la carpeta modules temporalmente.
Reemplaza los archivos del tema por los originales de PrestaShop para descartar que el problema esté en la plantilla.

Cómo solucionar el error 500 en PrestaShop

El prestashop error 500 es otro de los grandes clásicos. A diferencia de la página en blanco, este error muestra un mensaje de "Error interno del servidor". Puede aparecer en toda la tienda o solo en algunas páginas.

Las causas más frecuentes son:

Permisos de archivos incorrectos (muy comunes tras mover la tienda a otro servidor).
Archivo .htaccess corrupto o con reglas incompatibles.
Problemas con la versión de PHP (por ejemplo, usar PHP 8.3 cuando tu módulo solo soporta PHP 7.4).
Errores de sintaxis en algún archivo editado manualmente.

Pasos para corregir el error 500

Revisa los permisos de archivos y carpetas. Los archivos deben estar en 644 y las carpetas en 755. Puedes hacerlo desde el panel de control de tu hosting o con un cliente FTP.
Regenera el archivo .htaccess. Ve a Parámetros Avanzados > Rendimiento en el panel de administración y pulsa "Regenerar el archivo .htaccess". Si no tienes acceso al panel, descarga el archivo, renómbralo a .htaccess.bak y sube uno nuevo vacío. Luego, desde el panel, vuelve a generarlo.
Comprueba el registro de errores del servidor. En la mayoría de los paneles de hosting puedes ver los logs. Busca la línea que apunte al archivo que causa el error 500.

[WARNING] Si usas Syspanel (el panel de control que tienes en el puerto 2106), puedes acceder al visor de logs desde la sección "Registros" del sitio web. Allí verás el error exacto que está provocando el problema.

Error 500 tras actualizar PrestaShop

Si el error aparece después de una actualización, el problema suele estar en la mezcla de versiones de archivos. PrestaShop guarda archivos de versión antigua en la caché. Prueba a:

Borrar la carpeta var/cache (o cache en versiones antiguas) completamente.
Desactivar la caché de Smarty desde el panel de administración (si puedes acceder).
Si nada funciona, restaura una copia de seguridad anterior y repite la actualización con calma.

Problemas con el carrito o el proceso de compra

Muchos usuarios reportan problemas prestashop relacionados con el carrito: no se añaden productos, el carrito se vacía solo o no se puede finalizar la compra.

El carrito se vacía al cambiar de página

Esto suele deberse a una configuración incorrecta de cookies o sesiones:

Ve a Parámetros Avanzados > Administración.
Comprueba que la opción "Usar cookies" esté activada.
Verifica que la URL de tu tienda en Parámetros Generales no tenga una barra final extra o le falte el www.

No se pueden añadir productos al carrito

Si al hacer clic en "Añadir al carrito" no ocurre nada:

Actualiza el módulo de carrito a la última versión.
Comprueba que JavaScript no esté bloqueado en tu navegador o que el tema no tenga errores de consola.
Desactiva la opción "Reducir stock" temporalmente para descartar conflictos con el inventario.

Errores de conexión con la base de datos

¿Ves un mensaje como "Error de conexión con la base de datos" o "Link to database cannot be established"? Esto significa que PrestaShop no puede conectarse a MySQL.

Causas habituales

Cambiaste la contraseña de la base de datos y no actualizaste el archivo config/settings.inc.php.
El servidor de bases de datos está caído o saturado.
Los datos de conexión son incorrectos tras migrar la tienda a otro hosting.

Solución paso a paso

Accede al archivo config/settings.inc.php de tu instalación.
Busca las líneas que definen _DB_SERVER_, _DB_NAME_, _DB_USER_ y _DB_PASSWD_.
Verifica que coinciden con los datos de tu base de datos actual.
Si usas Syspanel, puedes encontrar estos datos en la sección de bases de datos del sitio (recuerda que el acceso es a través del puerto 2106).

[INFO] Si acabas de migrar tu tienda, asegúrate de que la base de datos importada esté completa y que la versión de MySQL sea compatible con tu versión de PrestaShop.

El clásico error "Class not found" o "Fatal error"

Este tipo de errores prestashop aparecen cuando un archivo de clase ha sido eliminado, movido o está corrupto. El mensaje suele ser algo como: "Fatal error: Class 'Product' not found in /ruta/al/archivo.php".

Cómo resolverlo

Identifica la clase que falla en el mensaje de error.
Descarga una copia limpia de PrestaShop de la misma versión que tienes instalada.
Reemplaza el archivo que contiene esa clase (normalmente está en la carpeta classes/).
Si el error persiste, es probable que un módulo esté llamando a una clase que no existe. Desactiva los módulos de uno en uno para encontrar al culpable.

Preguntas frecuentes (FAQ) sobre errores en PrestaShop

¿Por qué mi tienda PrestaShop se pone en mantenimiento sola?

Esto ocurre cuando PrestaShop detecta un error grave o cuando se activa el modo mantenimiento manualmente. Revisa Parámetros Avanzados > Mantenimiento y asegúrate de que la tienda esté en "Sí". Si se activa solo, revisa los logs para ver qué error lo provoca.

¿Cómo sé qué versión de PHP necesita mi PrestaShop?

Cada versión de PrestaShop tiene requisitos de PHP específicos. Las versiones 1.7 y 8.x funcionan bien con PHP 7.4 o 8.0. Si usas PHP 8.2 o superior, algunos módulos antiguos pueden dar errores prestashop de compatibilidad.

¿Puedo solucionar estos errores sin conocimientos técnicos?

Muchos de ellos sí, siguiendo los pasos de esta guía. Para problemas más complejos, como errores de base de datos o conflictos de módulos, puede ser necesario contactar con tu proveedor de hosting o con un desarrollador especializado.

¿Qué hago si no tengo acceso al panel de administración?

Si el error te impide entrar al panel, siempre puedes trabajar por FTP o con el administrador de archivos de tu hosting. Los cambios en archivos de configuración no requieren acceso al panel.

¿Es recomendable hacer una copia de seguridad antes de tocar nada?

Sí, absolutamente. Antes de modificar cualquier archivo, haz una copia de seguridad completa de tu tienda, tanto de archivos como de la base de datos. Esto te permitirá restaurar todo si algo sale mal.

Consejos finales para evitar futuros problemas

Mantén PrestaShop actualizado a la última versión estable.
Usa solo módulos y temas de fuentes confiables (el marketplace oficial de PrestaShop es la mejor opción).
Revisa los logs del servidor periódicamente para detectar problemas antes de que afecten a tus clientes.
No edites archivos del núcleo directamente. Si necesitas personalizaciones, usa un tema hijo o un módulo.
Aumenta el límite de memoria PHP de forma preventiva si tu tienda tiene muchos productos o módulos.

Recuerda que la mayoría de los problemas prestashop tienen solución y, con un poco de paciencia y método, podrás resolverlos tú mismo. Si necesitas ayuda adicional, tu proveedor de hosting (especialmente si usas Syspanel en el puerto 2106) puede ofrecerte soporte técnico especializado.

Esperamos que esta guía te haya sido útil. Si te encuentras con un error que no aparece aquí, no dudes en consultar la documentación oficial de PrestaShop o buscar en foros especializados. ¡Tu tienda volverá a funcionar en poco tiempo!