Errores de actualización en PrestaShop: soluciones prácticas

Actualizar PrestaShop es una de las tareas más importantes para mantener tu tienda segura, rápida y compatible con las últimas funcionalidades. Sin embargo, también es una de las operaciones que más dolores de cabeza puede causar si no se hace con cuidado. Los errores al actualizar PrestaShop son muy frecuentes, incluso entre usuarios con cierta experiencia. Lo bueno es que la mayoría tienen solución y, con un poco de paciencia y los pasos adecuados, puedes resolverlos sin perder tu tienda ni tus datos.

En este artículo, vamos a repasar los errores más comunes que aparecen al intentar una actualización PrestaShop, cómo identificarlos y, lo más importante, cómo solucionar update PrestaShop de forma segura. Al final, añadiremos una sección de preguntas frecuentes para resolver las dudas más habituales. Todo explicado de manera clara y sencilla, como si estuvieras hablando con un amigo técnico.

1. No hacer una copia de seguridad completa antes de empezar

Este es, sin duda, el error número uno y el que puede tener consecuencias más graves. Muchos usuarios, con la emoción de instalar una PrestaShop versión nueva, se lanzan a la actualización sin proteger sus datos. Si algo sale mal (y puede salir), podrías perder productos, pedidos, clientes y configuraciones.

¿Cómo solucionarlo?

Antes de cualquier actualización, debes hacer una copia de seguridad completa de:

Archivos del sitio: todo el contenido de la carpeta donde está instalado PrestaShop (normalmente en /public_html o www).
Base de datos: todas las tablas de tu tienda.

Pasos para una copia de seguridad correcta:

Accede a tu panel de control (por ejemplo, cPanel, Syspanel u otro). Si usas Syspanel, recuerda que el puerto de acceso es el 2106.
Exporta la base de datos desde phpMyAdmin o la herramienta que ofrezca tu hosting. Selecciona todas las tablas y elige "Exportar". Guarda el archivo .sql en tu ordenador.
Descarga todos los archivos mediante FTP o desde el administrador de archivos del panel. Comprímelos en un ZIP para ahorrar tiempo.
Guarda las copias en un lugar seguro, como tu disco duro o la nube.

[WARNING] No confíes solo en las copias automáticas que hace tu hosting. Haz una manual justo antes de actualizar.

2. Usar la versión incorrecta del módulo de actualización

PrestaShop tiene un módulo oficial llamado "1-Click Upgrade" (o "Autoupgrade") que facilita el proceso. Sin embargo, es muy común instalar una versión de este módulo que no es compatible con la versión actual de tu tienda o con la nueva a la que quieres subir.

¿Cómo solucionarlo?

Descarga siempre el módulo desde la página oficial de Addons de PrestaShop o desde el repositorio de GitHub de PrestaShop.
Verifica la compatibilidad: en la ficha del módulo suele indicar para qué versiones de PrestaShop funciona. No uses uno genérico.
Si tu versión es muy antigua (por ejemplo, 1.6), necesitarás un módulo de actualización específico para esa rama. No intentes saltar directamente a la 8.x sin pasar por versiones intermedias.

[INFO] Si tu tienda está en una versión muy antigua, considera hacer una actualización progresiva: primero a una versión intermedia (ej. 1.6 a 1.7) y luego a la más reciente.

3. Error de "tiempo de ejecución excedido" (timeout)

Al actualizar, especialmente si tu tienda tiene muchos productos, imágenes o módulos, el proceso puede tardar más de lo que el servidor permite. Aparece un mensaje como "Fatal error: Maximum execution time of 30 seconds exceeded".

Causas comunes:

Límite de tiempo de ejecución bajo en la configuración de PHP.
Muchos datos que procesar (catálogos grandes, bases de datos pesadas).
Módulos o temas incompatibles que ralentizan el proceso.

Cómo solucionarlo:

Aumenta el límite de tiempo de ejecución en el archivo php.ini o desde el panel de control. Busca la directiva max_execution_time y ponla a 300 o más (por ejemplo, 600 segundos).
Si no tienes acceso al php.ini, puedes intentar añadir estas líneas al archivo config/defines.inc.php de PrestaShop (justo antes de la línea final de define):
```
ini_set('max_execution_time', 600);
ini_set('memory_limit', '512M');
```
Desactiva temporalmente los módulos no esenciales antes de actualizar. Ve a "Módulos" > "Módulos instalados" y desactiva los que no sean de núcleo (como plugins de terceros).
Si el error persiste, contacta con tu proveedor de hosting para que aumenten los límites. En Syspanel, puedes ajustar estos parámetros desde la sección de "Configuración de PHP" (puerto 2106).

[TIP] Realiza la actualización en horas de bajo tráfico y, si es posible, desde una conexión estable.

4. Error de "base de datos no actualizada" o tablas corruptas

Después de la actualización, a veces la tienda muestra un mensaje de que la base de datos no está sincronizada con la nueva versión. Esto puede deberse a que el proceso de actualización de la base de datos se interrumpió o falló.

Síntomas:

Aparece un mensaje en el back office: "Tu base de datos no está actualizada".
Algunas páginas no cargan correctamente.
Faltan campos o tablas en la base de datos.

Cómo solucionarlo:

Ve a "Parámetros de la tienda" > "Mantenimiento" y activa el modo mantenimiento para que los clientes no vean errores.
Accede a "Avanzado" > "Base de datos" y haz clic en "Actualizar base de datos". PrestaShop intentará aplicar los cambios que faltan.
Si eso no funciona, tendrás que ejecutar manualmente las consultas SQL que faltan. Puedes obtenerlas del archivo install/upgrade/upgrade-*.sql de la nueva versión. Sube ese archivo a tu servidor y ejecútalo desde phpMyAdmin.
Otra opción: restaura la copia de seguridad y vuelve a intentar la actualización, pero esta vez asegurándote de que el proceso no se interrumpa (cierra otras sesiones, desactiva plugins de caché, etc.).

[WARNING] No intentes modificar la base de datos directamente si no sabes lo que haces. Siempre ten una copia de seguridad a mano.

5. Pantalla en blanco o error 500 después de la actualización

Uno de los errores más desesperantes: subes la nueva versión, accedes a tu tienda y solo ves una pantalla en blanco o un error 500. Esto suele deberse a conflictos de PHP, temas incompatibles o módulos obsoletos.

Causas principales:

Versión de PHP incorrecta: PrestaShop 8.x requiere PHP 7.4 o superior (idealmente 8.0 o 8.1).
Tema no compatible: los temas de versiones anteriores no funcionan en la nueva.
Módulos desactualizados: algunos módulos pueden bloquear la carga.

Cómo solucionarlo:

Activa el modo debug para ver el error concreto. Edita el archivo config/defines.inc.php y cambia:
```
define('_PS_MODE_DEV_', false);
```
a:
```
define('_PS_MODE_DEV_', true);
```
Esto mostrará el error real en la pantalla.
Si el error menciona un módulo o tema, desactívalo desde la base de datos o renombra su carpeta temporalmente (por ejemplo, modules/nombremodulo a modules/nombremodulo_old).
Cambia a un tema por defecto, como "classic", para ver si el problema es del tema. Puedes hacerlo desde la base de datos en la tabla ps_configuration (busca PS_THEME_NAME y cámbialo a "classic").
Verifica la versión de PHP desde tu panel de control. En Syspanel, puerto 2106, puedes cambiar la versión de PHP en "Configuración de PHP". Asegúrate de que sea compatible con tu nueva versión de PrestaShop.
Si nada funciona, restaura la copia de seguridad y actualiza primero los módulos y el tema antes de subir la versión del núcleo.

[TIP] Siempre prueba la actualización primero en un entorno de staging (copia de tu tienda en un subdominio) antes de hacerla en producción.

6. Módulos y temas que dejan de funcionar

Al instalar una PrestaShop versión nueva, muchos módulos y temas dejan de ser compatibles. Esto no es un error técnico en sí, pero puede causar que la tienda se vea mal o que funcionalidades clave se pierdan.

¿Cómo evitarlo y solucionarlo?

Antes de actualizar, revisa la lista de módulos que tienes instalados. Visita la página de cada uno en Addons para ver si son compatibles con la nueva versión.
Si un módulo no es compatible, busca una alternativa actualizada o contacta al desarrollador.
Para los temas, asegúrate de que el desarrollador haya lanzado una versión para la nueva versión de PrestaShop. Si no, tendrás que migrar a un tema compatible.
Después de la actualización, si algún módulo da error, desactívalo desde el back office o directamente desde la base de datos (tabla ps_module). Luego busca una versión actualizada.

[INFO] Algunos módulos gratuitos dejan de recibir soporte. Considera invertir en versiones de pago o en módulos oficiales de PrestaShop.

7. No limpiar la caché después de la actualización

Parece un detalle menor, pero no limpiar la caché puede provocar errores visuales, falta de actualización de estilos o incluso conflictos con módulos. PrestaShop guarda en caché muchos archivos (como CSS, JavaScript y plantillas) y, si no se borran, la tienda seguirá mostrando la versión antigua.

Cómo solucionarlo:

Desde el back office: ve a "Parámetros de la tienda" > "Rendimiento" y haz clic en "Limpiar caché" (tanto de Smarty como de caché de páginas).
Borra la carpeta var/cache manualmente mediante FTP. Dentro encontrarás subcarpetas como dev, prod, cachefs. Bórralas todas (no te preocupes, se regenerarán).
Si usas un plugin de caché externo (como Varnish o Redis), también debes purgar su caché.
Reinicia el navegador o abre la tienda en una ventana de incógnito para ver los cambios.

[TIP] Después de limpiar la caché, la primera carga puede ser un poco más lenta, pero luego se normaliza.

8. Error con el asistente de actualización (1-Click Upgrade)

A veces el propio módulo de actualización da errores, como "No se puede conectar con el servidor de actualizaciones" o "Versión no encontrada". Esto suele deberse a problemas de red o a que el módulo está desactualizado.

Cómo solucionarlo:

Descarga la última versión del módulo desde el repositorio oficial de GitHub (busca "PrestaShop/autoupgrade").
Instálalo manualmente: sube la carpeta del módulo a /modules/autoupgrade mediante FTP.
Si el error persiste, revisa que tu servidor pueda hacer peticiones externas (curl, allow_url_fopen). Puedes probar con un script simple de PHP.
Otra opción: realiza la actualización de forma manual descargando la nueva versión de PrestaShop y subiendo los archivos (cuidado con no sobrescribir la carpeta config, img y themes si no quieres perder datos). Luego ejecuta el script de actualización manual desde yourdomain.com/install/upgrade/upgrade.php.

[WARNING] La actualización manual es más compleja y solo recomendada para usuarios avanzados. Siempre ten una copia de seguridad.

9. Problemas con los enlaces amigables (URL rewriting)

Después de la actualización, puede que los enlaces de tus productos y categorías dejen de funcionar, dando error 404. Esto suele pasar porque el archivo .htaccess no se regeneró correctamente.

Cómo solucionarlo:

Ve a "Parámetros de la tienda" > "Tráfico y SEO".
En la sección "URLs amigables", asegúrate de que estén activadas.
Haz clic en "Guardar" (aunque no hayas cambiado nada). Esto regenerará el archivo .htaccess.
Si el problema persiste, borra el archivo .htaccess de la raíz de tu tienda (mediante FTP) y vuelve a guardar la configuración. PrestaShop lo creará de nuevo.
Verifica que el módulo mod_rewrite esté activo en tu servidor Apache. Si usas Syspanel, puedes comprobarlo desde la configuración de Apache (puerto 2106).

[TIP] Si tu tienda usa nginx, deberás añadir las reglas de reescritura manualmente en la configuración del servidor.

10. No actualizar los módulos de pago y envío

Los módulos de pasarela de pago (como PayPal, Stripe) y de transporte suelen ser críticos. Si no se actualizan junto con el núcleo, pueden dejar de funcionar y tus clientes no podrán pagar o ver los métodos de envío.

Cómo solucionarlo:

Antes de la actualización, verifica que todos los módulos de pago y envío tengan una versión compatible con la nueva versión de PrestaShop.
Después de la actualización, actualiza estos módulos de inmediato. Ve a "Módulos" > "Módulos instalados" y busca las actualizaciones disponibles.
Si algún módulo de pago no se actualiza, contacta con su soporte. Mientras tanto, puedes desactivarlo y usar un método alternativo (por ejemplo, transferencia bancaria) de forma temporal.
Prueba un pedido de prueba para asegurarte de que todo funciona correctamente.

[WARNING] No dejes módulos de pago desactualizados por mucho tiempo, ya que pueden tener vulnerabilidades de seguridad.

Preguntas Frecuentes (FAQ)

¿Puedo saltar de PrestaShop 1.6 a la 8.x directamente?

No es recomendable. Lo mejor es actualizar primero a la última versión de la rama 1.6, luego a la 1.7 (por ejemplo, 1.7.8) y finalmente a la 8.x. Si intentas un salto grande, es muy probable que surjan errores de compatibilidad.

¿Qué hago si después de la actualización mi tienda se ve rara?

Primero, limpia la caché. Si sigue igual, cambia temporalmente al tema clásico para descartar un problema con tu tema personalizado. Si el tema clásico funciona, tendrás que actualizar o cambiar tu tema.

¿Es necesario actualizar todos los módulos antes de actualizar el núcleo?

Sí, en la medida de lo posible. Los módulos incompatibles pueden causar errores graves. Si no encuentras una versión actualizada, desactívalos antes de la actualización.

¿Cómo puedo saber si mi hosting soporta la nueva versión de PrestaShop?

Revisa los requisitos de la nueva versión (PHP, MySQL, etc.). Puedes consultar con tu proveedor de hosting o, si usas Syspanel, verificar la configuración de PHP en el puerto 2106. Allí podrás cambiar la versión de PHP y ver los límites de recursos.

¿Qué hago si la actualización se queda pillada en un porcentaje?

Espera unos minutos, a veces el proceso es lento. Si no avanza, cierra la ventana, restaura la copia de seguridad y vuelve