Errores comunes en PrestaShop y cómo resolverlos

Una tienda PrestaShop que de pronto muestra una pantalla blanca, un error 500 o un checkout que no responde pone nerviosa a cualquiera, porque cada hora sin vender cuenta. La buena noticia es que la mayoría de estos errores de PrestaShop tienen causas repetidas: un módulo que choca con otro, una versión de PHP que no corresponde, una actualización a medias o un servidor corto de recursos. Esta guía te explica cómo reconocerlos, qué revisar primero y cuándo conviene llamar a quien mantiene tu tienda.

La mayoría de los errores de PrestaShop nacen de módulos incompatibles, versiones de PHP no soportadas, actualizaciones incompletas o límites del servidor. El orden de diagnóstico es: respaldar, activar el modo debug de forma temporal, revisar el error exacto, desactivar el último módulo o cambio hecho, y volver a probar. Si la tienda vende y el error toca el pago o el pedido, no improvises: restaura la copia y consulta a un especialista.

Imagen sugerida: una pila de capas de vidrio translúcido con una pieza ligeramente desalineada y un destello rosa de tensión entre capas. ALT: «Capas de una tienda PrestaShop donde un módulo desalineado genera un error».

Antes de tocar nada: respaldo y modo debug

Haz dos cosas antes de intentar cualquier arreglo. Primero, una copia completa de archivos y base de datos. Segundo, si no ves el motivo del error, activa el modo debug. Según la documentación oficial del proyecto, puedes hacerlo editando el archivo config/defines.inc.php y poniendo _PS_MODE_DEV_ en true, o desde el panel en Parámetros avanzados > Rendimiento. La propia documentación advierte que el modo debug reduce el rendimiento de forma notable, por lo que debes desactivarlo apenas termines. Nunca lo dejes encendido con clientes comprando: puede mostrar información que no debería verse.

Los errores más comunes y qué hacer

1. Pantalla blanca o error 500

Es el más temido porque no dice nada. Suele venir de un error de PHP que el servidor no muestra: un módulo recién instalado, un archivo de override dañado, memoria agotada o una versión de PHP incompatible. Revisa el último cambio que hiciste, activa el modo debug para leer el mensaje real y desactiva el módulo sospechoso. Si no puedes entrar al panel, puedes desactivar un módulo renombrando su carpeta en /modules/, siempre con respaldo previo.

2. La tienda se rompió después de actualizar

Es muy frecuente tras subir de versión. La lista de verificación posterior a la actualización de PrestaShop 9 recomienda recargar el panel, revisar el gestor de módulos para reactivar los que se desactivaron, comprobar el front office creando una cuenta y haciendo un pedido de prueba, y desactivar el modo mantenimiento solo cuando todo funcione. También aclara que los módulos incompatibles con tu versión se desinstalan. Si algo falla de fondo, existe una copia automática en la carpeta de respaldo de la herramienta de actualización para restaurar. Si vas a actualizar pronto, lee antes nuestra guía sobre cómo actualizar PrestaShop sin romper tu tienda.

3. Versión de PHP que no corresponde

Cada versión de PrestaShop acepta un rango de PHP. Según la documentación oficial, Según la documentación oficial, PrestaShop 9.0 funciona con PHP 8.1 a 8.4 (recomienda 8.4) y la 9.1 con PHP 8.1 a 8.5 (recomienda 8.5). Si tu hosting cambió la versión de PHP sin avisar, o la tienda quedó en una versión antigua, aparecen errores raros en módulos y temas. La solución es alinear PHP con la versión de PrestaShop y revisar que los módulos estén preparados para ella.

4. Imágenes que no cargan o miniaturas rotas

Después de una migración o actualización, es común que falten imágenes en la tienda. La documentación oficial indica regenerar las miniaturas desde Preferencias > Imágenes para productos, categorías y demás tipos. También revisa los permisos de la carpeta de imágenes y que la extensión GD de PHP esté activa.

5. Tienda lenta

Antes de culpar a PrestaShop, descarta tres causas simples: el modo debug encendido, la caché desactivada y un servidor con poca memoria. La documentación de producción recomienda que las plantillas solo se recompilen cuando cambian los archivos y que la caché esté activa. Los requisitos oficiales piden al menos 512 MB de límite de memoria por script y una versión reciente de base de datos. Si todo eso está bien, el siguiente sospechoso son los módulos: cada uno suma consultas y scripts. Un módulo que ya no usas debe desinstalarse, no solo desactivarse.

6. Conflictos entre módulos y overrides

Dos módulos que modifican la misma función, o un override antiguo que ya no coincide con el núcleo, pueden romper un carrito, un filtro o una página entera. El síntoma suele ser un comportamiento extraño solo en una parte de la tienda. Se diagnostica desactivando módulos de a uno y revisando la carpeta de overrides. Es la razón por la que conviene instalar pocos módulos, de fuentes confiables, y probarlos en una copia antes de producción. Si tu catálogo exige muchas funciones, mira qué módulos necesitas y cuándo conviene uno a medida.

7. El pago o el checkout fallan

Es el error más caro porque corta la venta. Las causas típicas son un módulo de pago desactualizado, credenciales mal configuradas, un certificado de seguridad vencido o un cambio reciente que alteró el flujo. Haz un pedido de prueba completo después de cualquier cambio y vigila los estados de los pedidos. Si el cobro falla de forma intermitente, no esperes: es un caso para soporte inmediato.

8. Los correos no llegan

Confirmaciones de pedido que no salen, o que caen en spam, son un problema silencioso. Suele deberse a la configuración del envío de correo, a registros de dominio incompletos o a límites del servidor. Prueba el envío desde el panel y revisa la configuración de correo con tu proveedor.

9. No puedes entrar al panel de administración

Tras un cambio de dominio, un error de caché o una actualización, el acceso al back office puede fallar. La documentación oficial indica que, si no puedes acceder, se puede activar el modo debug editando config/defines.inc.php para ver el error real. Desde ahí se identifica si es un módulo, una redirección o un permiso.

Tabla de diagnóstico rápido

Síntoma	Causa probable	Primer paso
Pantalla blanca o error 500	Módulo nuevo, override dañado, PHP o memoria	Respaldar, activar debug y leer el error
Falla tras actualizar	Módulos o tema incompatibles	Seguir la lista posterior a la actualización
Faltan imágenes	Miniaturas sin regenerar o permisos	Regenerar miniaturas y revisar permisos
Tienda lenta	Debug activo, caché apagada, poca memoria	Desactivar debug y activar caché
Comportamiento extraño en una sección	Conflicto de módulos u overrides	Desactivar módulos de a uno
Pago o checkout fallan	Módulo de pago, credenciales o certificado	Pedido de prueba y soporte inmediato

Cómo evitar que se repitan

• Mantén el núcleo, los módulos y el tema al día, con pruebas en una copia antes de producción.
• Haz respaldos automáticos y comprueba que se puedan restaurar.
• Instala solo los módulos que realmente usas y desinstala el resto.
• Documenta cada cambio: cuándo, qué y quién lo hizo. Así el error se asocia rápido a su causa.
• Elige un servidor que cumpla los requisitos oficiales; más detalle en hosting para PrestaShop.

Dónde entra Velox

Velox lleva más de 14 años y más de 300 proyectos de ecommerce, y trabaja con PrestaShop y Shopify. Cuando una tienda falla, lo que importa es corregir la causa y dejar la tienda protegida para que no vuelva a pasar. Para eso existe el soporte continuo por horas: corregimos, mantenemos y mejoramos tu tienda sin que tengas que armar un equipo técnico propio.

Preguntas frecuentes

¿Por qué mi PrestaShop muestra una pantalla en blanco?

Casi siempre hay un error de PHP oculto: un módulo nuevo, un override dañado, memoria insuficiente o una versión de PHP no compatible. Activa el modo debug de forma temporal para ver el mensaje real y vuelve a desactivarlo después.

¿Es seguro dejar el modo debug activado?

No. La documentación oficial advierte que reduce el rendimiento de forma notable, y además puede exponer información técnica. Úsalo solo para diagnosticar.

¿Qué versión de PHP necesito?

Depende de la versión de PrestaShop. Según la documentación oficial, PrestaShop 9.0 funciona con PHP 8.1 a 8.4 y recomienda 8.4. Confirma siempre el requisito de tu versión antes de cambiar PHP.

¿Puedo arreglarlo yo mismo?

Los pasos simples, como regenerar miniaturas o revisar el modo debug, sí. Si el error afecta el pago, los pedidos o necesita tocar archivos del servidor, lo más seguro es apoyarte en un especialista y trabajar siempre con respaldo.

Conclusiones

Los errores de PrestaShop más comunes se repiten: módulos, versiones de PHP, actualizaciones y recursos del servidor. Diagnosticar con orden, respaldar antes de tocar y mantener la tienda al día evita la mayoría. Y si el problema toca el cobro, no esperes.

¿Tu tienda PrestaShop está fallando o quieres evitar que falle? Cuéntanos en velox.ec/contactanos y la revisamos.

Fuentes

• Configuring PrestaShop (documentación oficial, modo debug y producción)
• Post-update checklist (documentación oficial)
• System requirements for PrestaShop 9 (documentación oficial)