Errores comunes en PrestaShop y soluciones: cómo arreglarlos hoy

errores comunes en PrestaShop y soluciones es una búsqueda recurrente cuando tu tienda se detiene en el peor momento: justo cuando llegan pedidos, durante una campaña o tras una actualización inesperada. En Entornodev vemos a diario cómo pequeñas incidencias se vuelven grandes dolores de cabeza por falta de diagnóstico, hosting inadecuado o una configuración poco optimizada. En esta guía práctica, te mostramos cómo identificar y arreglar hoy mismo los fallos más habituales de PrestaShop, con pasos claros y sin tecnicismos innecesarios. Y si quieres acelerar el proceso o delegarlo, nuestro equipo puede acompañarte con un plan de acción inmediato, ya sea en hosting optimizado, VPS o soporte experto.

Antes de tocar nada: diagnóstico rápido y seguro

Cuando aparece un fallo, el instinto suele ser “probar y ver”. Sin embargo, el camino más corto es un diagnóstico ordenado y una mínima copia de seguridad. Esto evita que un problema menor termine en caída total.

• Haz un backup de archivos y base de datos. Aunque sea parcial, te salva de sustos.
• Consulta Registros de error del servidor (error_log, logs de Apache/Nginx, PHP-FPM) y del propio PrestaShop.
• Activa modo debug solo temporalmente:
  • Desde el back office: Parámetros avanzados > Rendimiento > Modo depuración.
  • O en el archivo /config/defines.inc.php: define(_PS_MODE_DEV_, true);
• Desactiva cachés para probar (Smarty, CCC, OPCache a nivel de servidor al depurar).
• Si el error es crítico, prueba en una copia staging antes de tocar producción.

Con esta base, cualquier arreglo será más rápido y más seguro. Ahora sí, vamos uno por uno con los fallos frecuentes en PrestaShop y sus soluciones.

Errores tras instalar o actualizar PrestaShop

Error 500 después de instalar o actualizar módulos/tema

El temido Error 500 suele indicar excepciones PHP no controladas, incompatibilidades de versión o problemas de caché.

• Activa el modo debug para ver el error exacto (archivo o módulo causante).
• Vacía la caché manualmente: borra /var/cache/prod y /var/cache/dev (no elimines la carpeta var, solo su contenido).
• Comprueba la versión de PHP compatible con tu PrestaShop (PS 1.7.x suele ir bien con PHP 7.2-7.4; PS 8.x con PHP 8.1/8.2). Módulos antiguos pueden romper con PHP 8.
• Desactiva el módulo que acabas de actualizar desde la base de datos si no puedes acceder al back office:
  • Tabla ps_module: localiza el módulo y marca active = 0.
  • También puedes renombrar la carpeta /modules/nombre_modulo para desactivarlo temporalmente.
• Revisa permisos de archivos: carpetas 755, archivos 644, y propietario correcto (usuario del servicio web).

Cuando se trata de incompatibilidades graves entre tema y versión de PrestaShop, la mejor solución es actualizar el tema o volver a una snapshot previa. En Entornodev recomendamos usar un entorno staging para probar actualizaciones sin arriesgar ventas.

Pantalla en blanco (White Screen of Death)

Normalmente ocurre por errores fatales silenciados o por agotamiento de memoria.

• Activa debug y aumenta temporalmente memory_limit (por ejemplo, a 512M o 1024M) y max_execution_time (120-300s) en php.ini o .user.ini.
• Revisa extensiones PHP necesarias: intl, mbstring, json, gd o imagick, zip, curl, simplexml.
• Si aparece tras activar un módulo, desactívalo como se explicó arriba.
• Elimina caché de Smarty y de PrestaShop: /var/cache y /var/compile (según versión).

Conflictos de módulos y overrides

PrestaShop permite overrides de clases/controladores y hooks en módulos. Dos módulos sobre la misma clase pueden chocar.

• Temporalmente, renombra /override para comprobar si el fallo proviene de allí.
• En Parámetros avanzados > Rendimiento, desactiva “Desactivar todos los overrides” para probar.
• Revisa el orden de hooks y priorización en Diseño > Posiciones.

Si detectas un módulo conflictivo pero lo necesitas, valora reemplazarlo por uno compatible o solicitar a un desarrollador que mergee los overrides. En Entornodev podemos auditar la compatibilidad de tu stack de módulos.

Rendimiento lento: tienda y back office

Una tienda que carga lenta vende menos. El rendimiento deficiente se debe a una mezcla de hosting inadecuado, configuración de caché insuficiente y catálogos pesados sin optimizar.

Lentitud en el front: TTFB alto y páginas pesadas

• Activa CCC (Combine, Compress, and Cache) para CSS y JS desde Rendimiento.
• Habilita cache de Smarty en producción y “Nunca recompilar plantillas” (salvo al desarrollar).
• Implementa OPcache a nivel de PHP y ajusta su memoria para tu proyecto.
• Optimiza imágenes: usa WebP, compresión con imagick, y lazy load.
• Habilita un CDN o al menos subdominios de contenido estático para paralelizar cargas.
• Evita módulos que inyectan JS sin control; agrupa y retrasa scripts no críticos.
• Base de datos: añade índices faltantes en tablas con filtros frecuentes (ps_product, ps_category_product, ps_orders), y limpia logs pesados.

Back office lento o con timeouts

• Aumenta max_input_vars (por ejemplo, 5000-10000) si gestionas muchos atributos.
• Optimiza MySQL/MariaDB: ajusta innodb_buffer_pool_size (50-70% de la RAM en un VPS dedicado a DB).
• Desactiva estadísticas o paneles del dashboard que no usas.
• Si usas PrestaShop 1.7/8 en hosting compartido saturado, valora migrar a un VPS con NVMe y PHP-FPM ajustado.

En Entornodev hemos visto reducciones de carga del 40-70% solo con ajustes de servidor y caché. Un hosting optimizado para PrestaShop hace la diferencia.

Carrito, checkout y métodos de pago

Si el carrito falla, la facturación cae en picado. Aquí van los problemas más comunes.

El botón “Añadir al carrito” no hace nada

• Abre la consola del navegador y busca errores JavaScript. Suelen ser conflictos de tema o módulos de UX.
• Desactiva temporalmente módulos de pop-ups, chat o analítica uno a uno para aislar el causante.
• Comprueba que AJAX esté habilitado en el carrito si tu tema lo requiere.
• Regenera Friendly URLs y .htaccess si hay rutas rotas.

Checkout se queda “pensando” o no finaliza

• Revisa la configuración de transportistas y zonas. Un carrier mal configurado bloquea el paso.
• Comprueba módulos de pago: versiones, logs y credenciales.
• Desactiva One Page Checkout si es un módulo de terceros y prueba el flujo nativo.
• Verifica que el País/Provincia del cliente sea compatible con el transportista seleccionado.

Métodos de pago no aparecen

• Valida restricciones por moneda, país y grupo de clientes en cada método.
• Actualiza la moneda por defecto y redondeos; las incongruencias bloquean pagos.
• En sandbox, fuerza modo producción cuando ya estés listo para vender, y revisa webhooks/URLs de retorno.

Errores de URLs, SEO y redirecciones

Los problemas de Friendly URLs, canónicos o robots pueden disparar errores 404, duplicidad de contenido y pérdida de posicionamiento.

Errores 404 y .htaccess

• Regenera el archivo .htaccess desde Parámetros de la Tienda > Tráfico & SEO.
• Verifica que mod_rewrite esté activo en Apache o la reescritura correspondiente en Nginx.
• Evita reglas duplicadas o heredadas de migraciones anteriores.

Contenido duplicado y canónicas

• Activa URL canónica en productos y categorías (módulos SEO o ajustes del tema).
• Configura noindex en páginas con filtros infinitos o resultados internos de búsqueda.
• Usa redirecciones 301 al cambiar estructuras de URL; evita 302 salvo necesidad temporal.

Mapa del sitio y robots.txt

• Genera sitemap.xml actualizado e inviértelo en Search Console.
• Comprueba que robots.txt no bloquee recursos críticos (CSS/JS) que Google necesita renderizar.

Imágenes: miniaturas, calidades y formatos

Las imágenes mal generadas provocan páginas pesadas o rotas.

Miniaturas que no cargan o se ven deformadas

• Regenera imágenes desde Diseño > Imágenes, y verifica que gd o imagick estén activos en PHP.
• Revisa permisos de /img, /upload y subcarpetas.
• Si usas un CDN, purga la caché del CDN tras regenerar.

Optimización de peso y WebP

• Activa WebP si tu versión o tema lo soporta, o usa un módulo confiable.
• Aplica lazy loading en listados largos y banners.
• No subas imágenes gigantes: 1600-2000 px suelen ser suficientes para hero; 800-1200 px para producto.

Correos que no llegan: SMTP, reputación y SPF/DKIM/DMARC

Un ecommerce sin emails de pedido o recuperación de contraseña pierde confianza y conversiones.

• Usa SMTP autenticado con un proveedor transaccional (Mailgun, Sendinblue, Amazon SES) en vez de mail() del servidor.
• Configura SPF, DKIM y DMARC en tu dominio. Mejora la entregabilidad y evita spam.
• Revisa plantillas de email por idioma y traducciones; errores de variables pueden romper el envío.
• Migra a dominios dedicados para transaccionales si el principal está penalizado.

Base de datos: limpieza, índices y reparaciones

Con el tiempo, la base de datos acumula polvo: tablas pesadas, logs infinitos y consultas lentas.

Tablas corruptas o muy pesadas

• Ejecuta un CHECK/REPAIR desde phpMyAdmin o la consola (con precaución y backup previo).
• Limpia ps_connections, ps_connections_source, ps_logs y tablas de sesiones antiguas.
• Programa tareas CRON para podar datos obsoletos o exportarlos a almacenamiento frío.

Índices y consultas lentas

• Activa el slow query log y detecta consultas que superen 1-2s.
• Añade índices en campos usados en WHERE y ORDER BY de filtros frecuentes (categoría, fabricante, atributos).
• Si usas módulos de búsqueda avanzada, verifica su motor (Elasticsearch/OpenSearch) y recursos del servidor.

Seguridad: no te la juegues

Las tiendas son objetivos de bots y ataques. Una brecha compromete datos y reputación.

Buenas prácticas esenciales

• Cambia el nombre de la carpeta /admin y limita accesos por IP si es posible.
• Usa HTTPS en toda la tienda y fuerza redirección 301 desde HTTP.
• Aplica 2FA para accesos al back office y roles de empleados bien segmentados.
• Actualiza PrestaShop, módulos y PHP con regularidad, tras probar en staging.
• Instala un WAF y protección anti-bot en formularios (reCAPTCHA/hCaptcha).

Permisos y archivos sensibles

• Evita permisos 777. Usa 755/644 y propietario correcto.
• Bloquea acceso público a /var, /config, /docs con reglas del servidor.
• Impide listado de directorios en Apache/Nginx.

Multitienda, idiomas e impuestos

Las configuraciones globales vs. específicas por tienda pueden crear comportamientos inesperados en modo multitienda.

Traducciones que no se aplican

• Verifica si estás editando el contexto correcto (todas las tiendas o una tienda concreta).
• Desactiva caché temporal para ver los cambios al instante.
• Si el tema tiene su propio sistema de traducciones, edítalas desde su módulo.

Impuestos y reglas por país

• Configura zonas, países y estados con precisión y vincúlalos a transportistas.
• Revisa IVA intracomunitario, exenciones y validación de VAT.
• Haz pedidos de prueba con direcciones reales de los países objetivo.

Migraciones y cambios de dominio

Al mover tu tienda a otro servidor o dominio, suelen aparecer fallos de rutas, caché, cookies y certificados.

• Antes de migrar, reduce TTL del DNS para una propagación rápida.
• Después de mover, actualiza URL de la tienda en la base (ps_shop_url) y limpia caché.
• Regenera .htaccess y revisa redirecciones 301 para mantener SEO.
• Instala y fuerza SSL en el nuevo entorno.
• Prueba pagos, transporte y correos en el entorno final antes de abrir.

Actualizaciones de PrestaShop sin dolor

Actualizar de 1.6 a 1.7/8 o entre minor versions puede ser un campo minado si no se planifica.

Plan de actualización recomendado

• Monta un staging idéntico a producción.
• Audita compatibilidad de tema y módulos con la nueva versión.
• Actualiza PHP a una versión soportada y activa OPcache.
• Haz un backup completo y crea un punto de restauración rápido.
• Prueba: flujo de compra, búsqueda, cuentas de cliente, emails y panel.
• Ejecuta scripts de actualización de base de datos y reindexa.

Si lo prefieres, en Entornodev hacemos el proceso llave en mano con ventana de mantenimiento mínima y plan de rollback.

Errores de caché: cuando “nada cambia”

Muy habitual: haces una modificación y el front no refleja el cambio.

• En producción, pon Smarty en “Nunca recompilar” pero al editar, cámbialo a “Recompilar si los archivos han sido actualizados”.
• Purgar cachés: PrestaShop, CDN, OPcache (si editas código), y el navegador.
• Evita tener varias capas de caché en conflicto (módulos de cache + reverse proxy mal configurado).

Checklist exprés para arreglar la mayoría de fallos hoy

• Backup rápido de archivos y base de datos.
• Activar debug y revisar logs del servidor.
• Vaciar caché de PrestaShop y desactivar módulos recientes.
• Comprobar PHP y extensiones requeridas.
• Probar sin overrides y con un tema nativo si es posible.
• Revisar permisos y propietario de archivos.
• Si es rendimiento, activar CCC, OPCache y WebP; optimizar imágenes y DB.
• Si es checkout/pago, revisar carriers, restricciones y logs del gateway.
• Si es SEO/URLs, regenerar .htaccess y sitemap.
• Si es email, configurar SMTP + SPF/DKIM/DMARC.

Historias breves: lo que aprendimos arreglando tiendas

Una tienda de moda nos llamó porque el checkout no avanzaba después de elegir transporte. El culpable: una regla de zona mal asignada a un transportista gratuito por encima de 50€. Al corregir la zona y limpiar caché, la conversión se recuperó en horas.

En otro caso, un comercio B2B sufría tiempos de carga de 6-8 segundos. Tras moverlo a un VPS con discos NVMe y PHP-FPM, activar OPcache y aplicar WebP, bajamos a 1,4-2,2 segundos. Mismo catálogo, ventas +18% en dos semanas.

Y sí, vimos una “pantalla blanca” que resultó ser un módulo de newsletter desactualizado incompatible con PHP 8.1. Renombrar la carpeta del módulo, limpiar caché y volver a una versión compatible resolvió el bloqueo en 10 minutos.

Cómo puede ayudarte Entornodev hoy

Si no tienes tiempo para pelearte con logs, versiones y módulos, podemos encargarnos y dejar tu tienda lista para vender.

• Hosting optimizado para PrestaShop: servidores afinados con PHP-FPM, OPcache, HTTP/2-3, CDN opcional y soporte experto.
• VPS gestionado: recursos dedicados, seguridad reforzada, monitorización 24/7 y escalado a demanda.
• Soporte técnico: auditoría, resolución de errores 500/404/503, compatibilidad de módulos, caché y rendimiento.
• Dominios y correos profesionales: configuración completa con SPF/DKIM/DMARC para que tus emails lleguen.
• Expertos en WordPress para tu blog corporativo integrado con tu PrestaShop, mejorando SEO y captación.
• Planes de mantenimiento: actualizaciones seguras, backups, staging y hardening.

Nuestro enfoque es simple: diagnóstico claro, solución rápida y resultados medibles. Si lo necesitas, contáctanos y te proponemos un plan en menos de 24 horas.

Preguntas frecuentes rápidas

¿Puedo arreglar un error 500 sin tocar código?

Muchas veces sí. Con debug activado, desactivando el último módulo/tema, ajustando PHP y purgando cachés, se resuelve sin modificar archivos. Si hay incompatibilidad profunda, hará falta actualizar el módulo o pedir soporte.

¿Por qué mi tienda va lenta si tengo “buen hosting”?

“Bueno” es relativo. PrestaShop se beneficia de CPU rápida, discos NVMe, cachés bien configuradas y una base de datos optimizada. Un hosting genérico puede no ofrecer la afinación específica que tu tienda necesita.

¿Es obligatorio usar SMTP externo?

No es “obligatorio”, pero sí altamente recomendado. La entregabilidad mejora y reduces el riesgo de que los correos acaben en spam.

¿Cada cuánto conviene actualizar PrestaShop?

Depende del riesgo y de tus módulos. Sugerimos un ciclo trimestral o semestral con pruebas en staging. Para parches de seguridad críticos, cuanto antes.

Errores menos obvios que también pasan

• CRON desincronizado: tareas programadas que no corren rompen feeds, índices y recordatorios de carrito.
• Cache del navegador agresiva: ves la tienda “congelada” mientras el servidor ya cambió.
• Firewall del proveedor de pagos: bloquea peticiones desde tu IP si no está en lista blanca.
• Desbordes de stock: reglas de disponibilidad confusas que impiden compra sin avisar.
• JS duplicado: el mismo script cargado por tema y módulo provoca errores intermitentes.

Plan de acción en 60 minutos

1. 10 min: backup rápido + activar debug + revisar error_log.
2. 15 min: vaciar cachés (PS, OPCache, CDN), desactivar último módulo/tema y probar.
3. 15 min: verificar PHP/extensiones, permisos y .htaccess.
4. 10 min: prueba de checkout end-to-end en modo invitado y registrado.
5. 10 min: si persiste, duplicar en staging y aislar por binario (activar/desactivar por bloques).

Si no se resuelve, es momento de escalar a un equipo técnico. En Entornodev trabajamos con prioridad cuando hay ventas en riesgo.

Conclusión: arregla hoy, crece mañana

Los errores comunes en PrestaShop y sus soluciones rara vez son magia: son método, buena configuración y un entorno sólido. Con un diagnóstico ordenado y las prácticas que te compartimos, puedes recuperar tu tienda hoy mismo y sentar las bases para que mañana venda más y mejor.

¿Listo para dejar atrás los fallos recurrentes? Da el siguiente paso con tu hosting Prestashop SSD en Entornodev, hostings optimizados para tu tienda en Prestashop y soporte experto a tu medida.