El asistente de actualización de PrestaShop (Update Assistant): cómo usarlo y por qué falla

El asistente de actualización (Update Assistant, el módulo autoupgrade, antes «1-Click Upgrade») es la herramienta oficial para pasar PrestaShop de una versión a otra. En muchas tiendas funciona a la primera. Cuando falla, suele hacerlo a mitad, con un error 500 o un «Algo salió mal...». Además trae marcada una opción que desinstala los módulos que no da por compatibles, con sus datos. Esto es lo que hemos aprendido usándolo en migraciones reales a la 8 y la 9, comprobado en su código (versión 7.6.6).

Lo que comprueba antes de dejarte empezar

Al abrirlo, el asistente revisa la tienda. Lo que sale con una cruz roja no te deja seguir; lo naranja es un aviso. Lo que más nos encontramos:

• El modo mantenimiento tiene que estar activado, con tu IP añadida (Parámetros de la tienda → General → Mantenimiento). Lo explicamos en el modo mantenimiento.
• La caché de PrestaShop, desactivada (Parámetros avanzados → Rendimiento).
• El PHP del alojamiento: más de 256 MB de memoria, un max_execution_time alto o sin límite, la extensión zip y allow_url_fopen o cURL.
• Permiso de escritura en la carpeta de la tienda y en la del asistente.
• Un PHP que valga para la versión de destino. Por eso desde la 1.7 no se llega a la 9 de un salto: hay que pasar por la 8.
• Ficheros del núcleo o del tema cambiados. Es un aviso, pero lo que se haya tocado ahí se sobrescribe.
• Que el propio módulo esté al día. Si no, avisa de que tu versión está desfasada.

Y ten sitio en el disco: tiene que descargar la versión nueva, descomprimirla y guardar su copia. En nuestras migraciones, cuenta como mínimo el doble de lo que ocupa la tienda sin las imágenes.

Los módulos «incompatibles» se desinstalan (con sus datos)

Entre las opciones hay una, «Uninstall incompatible modules» (en nuestra copia en español todavía sale en inglés), que viene marcada. Desinstala antes de actualizar los módulos que da por incompatibles con la versión de destino, y el propio asistente avisa de que se pierden su configuración y sus datos. Desactivar un módulo no es lo mismo que desinstalarlo: lo explicamos en módulos de PrestaShop.

Lo importante es cómo decide qué es incompatible. Mira en Addons, la tienda oficial de módulos, si hay una versión del módulo para la versión de destino. Si el módulo está en Addons y ninguna versión declara la de destino, lo desinstala, aunque el tuyo funcione. Nos pasó con un módulo de pago y otro de envíos muy conocidos: en Addons ponía «hasta la 9.1» y el salto era a la 9.2. Los que no están en Addons (a medida o comprados fuera) salen como «compatibilidad incierta»: no los toca, pero tampoco sabe si van a funcionar.

• Mira la lista antes de empezar. Sale en las comprobaciones, y por consola con update:check-modules.
• Para cada módulo que quieras conservar, consigue antes su versión para la de destino o pregunta a quien te lo vendió.
• Si el módulo se conecta con un servicio de fuera (pagos, envíos, facturación), al desinstalarse puede desconectar tu cuenta de ese servicio. Míralo antes.
• Si desmarcas la opción, el módulo se queda, pero si de verdad no es compatible puede romper la tienda después: lo contamos en «este módulo no es compatible».

Las otras opciones

• «Desactivar módulos no nativos»: solo cuenta si vas a la 8 o a una anterior, y entonces hay que volver a activarlos al terminar. Al ir a la 9 ya no los desactiva.
• «Regenerar plantillas de correo electrónico»: viene marcada. Si tus correos están personalizados, se sobrescriben: desmárcala o guarda antes la carpeta mails.
• «Desactivar todos los métodos overrides»: viene desmarcada. Si tu tienda usa overrides, mejor revisarlos antes que apagarlos a ciegas.

Error 500, «Algo salió mal…» o se queda parado

«Algo salió mal...» («Something went wrong...») es la pantalla de error genérica del asistente: lleva un código, pero no dice la causa. La causa está en sus registros, en autoupgrade/logs dentro de la carpeta del panel, y en el registro de errores de PHP de tu alojamiento. Lo que más hemos visto:

• Se acaba el tiempo. Desde el panel, cada paso tiene que caber en el max_execution_time del alojamiento. Con 30 segundos, los pasos largos se cortan con un error 500.
• Falta memoria o falta la extensión zip.
• Se cierra o se duerme la pestaña. Desde el panel, quien va lanzando cada paso es tu navegador: si la pestaña se cierra o se queda colgada, la actualización se para sin avisar.
• La tienda falla al terminar, por un módulo o por el tema. Eso ya es el error 500 de PrestaShop de siempre.

Si se paró mientras copiaba los ficheros o cambiaba la base de datos, la tienda está a medio actualizar. No la abras al público ni vuelvas a empezar desde cero: o la reanudas por consola desde el paso donde se quedó, o restauras la copia.

Por consola, sin los límites del panel

Si tu alojamiento te da acceso por SSH, es la forma más fiable: no depende del navegador ni del tiempo máximo del servidor web. No hace falta tener el módulo instalado, basta con que esté en la carpeta modules. Desde la carpeta de la tienda, y cambiando admin123 por el nombre de la carpeta de tu panel:

php modules/autoupgrade/bin/console update:check-requirements admin123
php modules/autoupgrade/bin/console update:check-modules admin123
php modules/autoupgrade/bin/console update:start admin123

El primero repite las comprobaciones; el segundo, la lista de módulos; el tercero actualiza. Si se para, --action= lo reanuda desde el paso que le digas, y con backup:create y backup:restore haces y restauras sus copias.

Un detalle que nos costó una noche: para algunos pasos, el asistente vuelve a llamar a php a secas. Si en tu servidor ese php es otra versión (en algunos alojamientos, una más antigua que la de la web), se para a mitad. Comprueba antes que php -v da la misma versión que usa la tienda.

La copia del asistente no basta

El asistente hace su propia copia (completa o sin imágenes) y la guarda en autoupgrade/backup, dentro de la carpeta del panel, es decir, en el mismo servidor. Y restaurarla desde el panel tiene el mismo límite de tiempo: en un alojamiento con 30 segundos se nos quedó a medias y dejó la tienda en error 500. Haz además tu propia copia de los ficheros y de la base de datos, fuera del servidor, y prueba que se puede restaurar: cómo hacer la copia de seguridad.

Preguntas frecuentes

Comprobado el 3 de noviembre de 2026 en la documentación oficial de PrestaShop 9 (actualizar desde el panel, por consola y después de actualizar) y en el código del asistente 7.6.6: las comprobaciones, cómo decide qué módulo es incompatible y qué opción deja de contar al ir a la 9.

← Volver al blog