Errores después de actualizar PrestaShop 9: qué revisar y en qué orden

Has actualizado y algo no va: la tienda en blanco, un módulo «no compatible con esta versión», el pago con tarjeta que ya no sale, correos que no llegan o un panel que no te deja entrar. Casi todo tiene una causa conocida, documentada por PrestaShop, y se arregla sin deshacer la actualización. Busca tu síntoma.

1. Lo primero: la lista oficial de después de actualizar

PrestaShop publica lo que hay que hacer nada más terminar. Empieza por ahí: varios de los «errores» de esta guía son pasos de esa lista.

• Vuelve a entrar en el panel. La actualización cierra la sesión.
• Revisa el gestor de módulos. Si has saltado a la 8, el asistente desactiva por defecto los módulos que no vienen de serie y hay que volver a activarlos. Al saltar a la 9 ya no los desactiva: lo hemos comprobado en su código.
• Mira qué módulos han desaparecido. Según la propia documentación, los compatibles se actualizan solos y los que no son compatibles con la versión nueva se desinstalan, con sus ajustes y sus datos. Cómo decide cuáles, en el asistente de actualización.
• Prueba la tienda como un cliente: crea una cuenta, añade un producto al carrito y haz un pedido de verdad.
• Quita el modo mantenimiento (Parámetros de la tienda → General → Mantenimiento).
• Si faltan imágenes en la tienda, regenera las miniaturas desde la página de imágenes del menú Diseño.

2. La tienda o el panel salen en blanco o con error 500

Una página en blanco o un error 500 justo después de actualizar suele ser código que no está preparado para la versión nueva. PrestaShop 9 cambió mucho por dentro: pasó de Symfony 4.4 a Symfony 6.4 y ya no funciona con PHP anterior a 8.1. Lo primero es ver el error real:

• Activa el modo depuración: en config/defines.inc.php, cambia _PS_MODE_DEV_ a true. Es lo que recomienda la documentación oficial si no puedes entrar al panel. Desactívalo en cuanto termines, porque enseña información interna a cualquiera.
• Si el error nombra un módulo, desactívalo cambiando el nombre de su carpeta dentro de modules/ por FTP. Si la tienda vuelve, ya tienes al culpable.
• Si nombra un fichero de override/, el problema es una modificación del núcleo hecha para la versión anterior. Desde el panel, en Parámetros avanzados → Rendimiento, hay un interruptor para desactivar todos los overrides de golpe. Sin panel, se aparta ese fichero y se vacía var/cache/.
• Vacía la caché (var/cache/) después de cada cambio, aunque no veas nada raro.
• Comprueba el PHP. La 9.0 funciona con PHP 8.1 a 8.4, y la 9.1 y la 9.2, con PHP 8.1 a 8.5. Si tu alojamiento tiene otra versión, no hay módulo que lo arregle: qué PHP necesita tu PrestaShop.

Tienes el detalle en error 500 en PrestaShop y en la pantalla en blanco.

3. «Este módulo no es compatible con esta versión»

Cada módulo dice en su código con qué versiones de PrestaShop funciona. Si dice «hasta la 8», la 9 no lo deja instalar. Y al actualizar, el asistente desinstala los que en Addons, la tienda oficial de módulos, no tienen versión para la 9. No es un capricho: con la 9 desaparecieron piezas en las que se apoyaban muchos módulos, como la librería Guzzle, con la que algunos módulos se comunicaban con otros servicios, o la forma antigua de hacer las pantallas del panel.

• Pide la versión para la 9 a quien te vendió el módulo, o búscala en la tienda de módulos de PrestaShop (Addons).
• No fuerces la compatibilidad cambiando ese número en el código. El aviso desaparece, pero el módulo sigue usando lo que ya no existe y falla después, a veces en mitad de una compra.
• Si el módulo está abandonado, toca buscar otro que haga lo mismo o adaptarlo a medida. Antes de decidir, mira qué datos guardaba: al desinstalarse, un módulo puede borrar sus tablas.

4. El pago con tarjeta o los transportistas han desaparecido

Es el susto más caro, porque la tienda parece funcionar pero no cobra. Hay dos causas habituales:

• Están desactivados o desinstalados. El pago y los envíos casi siempre son módulos de terceros. Al saltar a la 8, el asistente los desactiva por defecto: actívalos de uno en uno desde el gestor de módulos. Al saltar a la 9 no los desactiva, pero desinstala los que Addons no da por compatibles con la 9: hay que instalar su versión para la 9 y volver a configurarlos. Después, haz una compra de prueba con cada forma de pago.
• El banco no puede avisar a tu tienda. Desde la 9, PrestaShop bloquea las llamadas directas a ficheros .php dentro de la carpeta modules/ (responden con un error 403). Un módulo de pago antiguo que recibía así el aviso del banco deja de crear el pedido, aunque el cobro se haya hecho. Si ves pagos en tu pasarela que no aparecen como pedidos, es la primera sospecha: hace falta la versión del módulo preparada para la 9.

Si usas la 9.2 y activas el nuevo pago en una sola página, PrestaShop pide probar antes los módulos de pago y de transporte con ese flujo. Más causas, en pagos que fallan en PrestaShop.

5. Los correos han dejado de salir (o salen distintos)

• Ya no hay cifrado SSL. La 9 cambió el sistema de envío de correo y quitó la opción SSL: quedan TLS o «Ninguno», y en la 9 «TLS» quiere decir cifrar desde el primer momento, que va por el puerto 465. Entra en la configuración de correo de Parámetros avanzados («Dirección de correo electrónico»): con el 465, elige TLS; con el 587, elige «Ninguno», y la tienda pide el cifrado por su cuenta (STARTTLS) si el servidor lo ofrece. TLS con el 587 da «wrong version number» y los correos dejan de salir: si en la 8 enviabas con 587 y TLS, cámbialo. Microsoft 365 solo admite el 587. Manda un correo de prueba y, si falla, el motivo está en Parámetros avanzados → Registros («Mailer Error»). Lo contamos paso a paso en PrestaShop no envía correos.
• Tus plantillas de correo han vuelto a las de serie. El asistente trae marcada por defecto la opción de regenerar las plantillas de correo. Si las tenías personalizadas, se han sobrescrito: recupéralas de la copia de antes de actualizar.

Si no sale ningún correo, sigue los pasos de PrestaShop no envía correos.

6. No puedo entrar al panel o me devuelve al inicio de sesión

En la 9, el acceso al panel se rehízo entero, con otra forma de guardar la sesión. Por eso hay que volver a entrar después de actualizar, y por eso algunos trucos de versiones anteriores ya no sirven:

• El ajuste PS_SSL_ENABLED_EVERYWHERE ya no existe. En la 9 el HTTPS de toda la tienda depende solo de PS_SSL_ENABLED.
• Detrás de Cloudflare, un balanceador o un proxy, PrestaShop puede no darse cuenta de que la conexión es segura y devolverte al inicio de sesión una y otra vez. La 9 añadió para eso la variable PS_TRUSTED_PROXIES, en el fichero .env de la raíz de la tienda, donde se indican las direcciones de los proxies en los que confiar.
• Vacía la caché (var/cache/) y prueba en una ventana privada.
• Si es la contraseña y tienes acceso por SSH, la 9.2 trae un comando para cambiarla: php bin/console prestashop:employee:change-password.

El resto de causas, en no puedo entrar al panel de PrestaShop.

7. En el panel falta algo que antes estaba

• Pestañas o campos de módulos en la ficha de producto. La 9 solo tiene la ficha de producto nueva; la antigua ya no existe. Los módulos que añadían cosas a la antigua no aparecen hasta tener una versión para la nueva.
• Páginas del panel que se ven distintas. Varias pantallas se han rehecho (carritos, atributos y características, ajustes de imágenes, estados de pedido…). Las direcciones antiguas te redirigen a las nuevas, pero lo que un módulo añadía a la pantalla vieja deja de salir.
• Las palabras clave meta ya no existen en la 9. No afecta a Google, que no las usa, pero algún módulo de SEO antiguo puede quejarse.

8. ¿Vuelvo a la versión anterior?

Si hiciste la copia con el asistente, está en autoupgrade/backup, dentro de la carpeta del panel, y se restaura desde el propio asistente, con su opción de restaurar una copia. Antes de hacerlo, ten en cuenta dos cosas:

• Lo que haya pasado desde la actualización se pierde: pedidos, clientes nuevos, cambios de stock. Apúntalos antes.
• En alojamientos que cortan los procesos largos, la restauración desde el panel puede quedarse a medias. Ten siempre una copia propia que sepas restaurar sin el panel.

Después de restaurar, la lista oficial pide quitar el modo mantenimiento y, si no puedes entrar al panel, vaciar la caché.

Cuándo merece la pena que lo hagamos nosotros

• Rescate de tienda PrestaShop: tienda o panel caídos después de actualizar. Desde 149 €, empezamos el mismo día laborable.
• Migración a PrestaShop 9: si todavía no has actualizado, lo ensayamos antes en una copia. Desde 390 €.
• Cómo actualizar a la 9 sin que se rompa nada: la guía de antes de actualizar.
• Mantenimiento PrestaShop: actualizaciones, módulos y copias en manos de alguien que los vigila. Desde 79 €/mes.

Preguntas frecuentes

Fuentes oficiales, consultadas el 24 de octubre de 2026: lista de comprobación después de actualizar y actualizar desde el panel; cambios de la 9.0, la 9.1 y la 9.2; requisitos del sistema; y en el código de PrestaShop, el bloqueo de ficheros en modules/ y la variable PS_TRUSTED_PROXIES.

← Volver al blog