Actualizar PrestaShop: Errores Comunes y Soluciones

Antes de empezar: la importancia de una buena preparación

Actualizar PrestaShop es una tarea que, bien hecha, mejora el rendimiento, la seguridad y la compatibilidad de tu tienda online. Sin embargo, cuando algo sale mal, puede convertirse en una pesadilla. La mayoría de los errores que veremos a continuación no son fallos del sistema, sino consecuencia de una preparación insuficiente o de pasos omitidos durante el proceso.

Piensa en la actualización como una mudanza: si no etiquetas las cajas y no tienes un plano de la nueva casa, acabarás perdiendo cosas o rompiendo muebles. Con PrestaShop ocurre exactamente lo mismo. Por eso, antes de lanzarte a pulsar el botón de actualizar, asegúrate de tener un plan claro y, sobre todo, una copia de seguridad completa y funcional.

[WARNING] Nunca actualices PrestaShop directamente en tu tienda en producción sin hacer una copia de seguridad completa (archivos y base de datos) y probar la actualización en un entorno de pruebas. Un fallo puede dejarte la tienda inaccesible durante horas.

Error 1: Olvidar la copia de seguridad (o hacerla mal)

Este es, con diferencia, el error más común y el que más sustos provoca. Muchos usuarios creen que con descargar la carpeta public_html es suficiente, pero se olvidan de la base de datos MySQL, que es donde se almacenan los productos, pedidos y clientes. Sin una copia de la base de datos, es imposible revertir los cambios si la actualización falla.

Cómo solucionarlo

Realiza siempre una copia de seguridad completa siguiendo estos pasos:

Archivos: Descarga toda la carpeta raíz de PrestaShop (normalmente public_html o www) mediante FTP o el administrador de archivos de tu panel de control.
Base de datos: Exporta la base de datos desde phpMyAdmin o mediante la herramienta de backup que incluya tu panel. Si usas Syspanel (el panel de control que se accede por el puerto 2106), busca la sección de bases de datos y utiliza la opción de exportar.
Verifica la copia: No asumas que la copia es correcta. Intenta restaurarla en un servidor local o de pruebas para asegurarte de que no está corrupta.

[INFO] Una buena práctica es guardar al menos dos copias de seguridad en lugares distintos (por ejemplo, en tu ordenador y en un disco duro externo o servicio en la nube).

Error 2: No comprobar los requisitos del servidor

PrestaShop, como cualquier software, tiene unos requisitos mínimos de PHP, MySQL y configuración del servidor. Si tu servidor no los cumple, la actualización fallará o dará errores extraños como pantallas en blanco o mensajes de incompatibilidad.

Cómo solucionarlo

Antes de actualizar, consulta la documentación oficial de la versión a la que quieres migrar. Los requisitos más habituales que debes comprobar son:

Versión de PHP: Asegúrate de que tu servidor soporta la versión de PHP requerida. Puedes verlo desde el administrador de archivos o creando un archivo info.php con el contenido <?php phpinfo(); ?>.
Extensiones PHP: PrestaShop necesita extensiones como curl, gd, mbstring, openssl y pdo_mysql. Si alguna falta, la actualización dará errores.
Memoria límite: A veces, el límite de memoria de PHP es demasiado bajo. Puedes aumentarlo temporalmente añadiendo memory_limit = 256M al archivo php.ini o .htaccess.

[TIP] Si usas Syspanel (acceso por el puerto 2106), revisa la sección de "Configuración de PHP" para ajustar estos parámetros de forma gráfica sin necesidad de tocar archivos de configuración.

Error 3: Actualizar desde una versión muy antigua

PrestaShop no permite saltar de una versión muy antigua (por ejemplo, 1.6) directamente a la última (1.8 o superior). Si intentas hacerlo, el proceso fallará o corromperá la base de datos.

Cómo solucionarlo

Debes realizar actualizaciones progresivas: primero a la versión inmediatamente superior, y luego ir subiendo paso a paso. Por ejemplo:

De 1.6.x a 1.7.x.
De 1.7.x a la última versión estable.

Consulta la documentación oficial para conocer la ruta de actualización recomendada. Este proceso es más lento, pero mucho más seguro y evita errores de compatibilidad.

[WARNING] Intentar saltar versiones es una de las causas más frecuentes de errores graves en la base de datos. No lo hagas, aunque te lleve más tiempo.

Error 4: Tener módulos o temas incompatibles

Los módulos y temas que funcionaban en tu versión anterior pueden no ser compatibles con la nueva. Esto puede provocar errores de JavaScript, conflictos en la base de datos o que la tienda directamente no cargue.

Cómo solucionarlo

Antes de actualizar: Haz una lista de todos los módulos y temas instalados. Visita sus páginas de descarga y comprueba si tienen versiones compatibles con la nueva versión de PrestaShop.
Desactiva todo: Antes de lanzar la actualización, desactiva todos los módulos no esenciales y cambia al tema por defecto (el que viene con PrestaShop). Esto minimiza los conflictos.
Después de actualizar: Activa los módulos uno a uno y comprueba que todo funciona correctamente. Si uno da problemas, desactívalo y busca una alternativa o contacta con su desarrollador.

[TIP] Si un módulo es crítico para tu negocio y no tiene versión compatible, plantéate si merece la pena actualizar o si puedes esperar a que el desarrollador lo actualice.

Error 5: No limpiar la caché después de actualizar

A veces, la actualización se completa correctamente, pero la tienda muestra errores o un diseño roto porque la caché antigua sigue activa. Esto es muy común y fácil de solucionar.

Cómo solucionarlo

Desde el panel de administración: Ve a Parámetros Avanzados > Rendimiento y pulsa el botón "Vaciar la caché".
Desde el servidor: Si no puedes acceder al panel, borra manualmente la carpeta var/cache (en versiones 1.7) o cache (en versiones 1.6) mediante FTP. No te preocupes, se regenerará automáticamente.
Caché del navegador: Pide a tus clientes que hagan una recarga forzada (Ctrl+F5) o prueba en modo incógnito para ver si el problema es solo de caché local.

[INFO] Algunos módulos de caché (como los de terceros) pueden requerir una limpieza adicional. Consulta la documentación del módulo si los usas.

Error 6: Problemas con los permisos de archivos

Durante la actualización, PrestaShop necesita escribir en ciertos archivos y carpetas. Si los permisos son demasiado restrictivos, el proceso fallará con errores de "no se puede escribir" o "permiso denegado".

Cómo solucionarlo

Establece permisos correctos: La mayoría de los archivos deben tener permisos 644 y las carpetas 755. Puedes cambiarlos desde tu cliente FTP o desde el administrador de archivos de Syspanel (puerto 2106).
Especial atención a config/, var/ y cache/: Estas carpetas suelen necesitar permisos más permisivos durante la actualización (por ejemplo, 775 o 777), pero debes volver a los permisos estándar una vez terminado el proceso por seguridad.

[WARNING] No dejes permisos 777 en todo el servidor. Es un riesgo de seguridad grave. Solo úsalos temporalmente y revierte los cambios.

Error 7: La pantalla blanca de la muerte (WSOD)

Este es el error más temido: la tienda se queda en blanco y no muestra ningún mensaje. Puede deberse a un error de PHP, a un módulo incompatible o a un fallo en la actualización.

Cómo solucionarlo

Activa el modo de depuración: Edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Esto mostrará el error concreto en pantalla.
Revisa los logs: Si no puedes activar el modo dev, revisa los logs del servidor. En Syspanel (puerto 2106) puedes acceder a los logs de error desde la sección de "Registros".
Desactiva módulos por FTP: Si el error aparece tras activar un módulo, renombra la carpeta del módulo en /modules/ para desactivarlo temporalmente.
Restaura la copia de seguridad: Si nada funciona, restaura la copia de seguridad que hiciste al principio y vuelve a intentarlo con más calma.

[TIP] El modo de depuración es tu mejor amigo para diagnosticar errores. Actívalo siempre que tengas problemas y desactívalo cuando termines.

Error 8: La base de datos se queda a medias

Durante la actualización, la base de datos se modifica en varias fases. Si el proceso se interrumpe (por un corte de conexión, por ejemplo), la base de datos puede quedar en un estado inconsistente.

Cómo solucionarlo

Utiliza la herramienta de reparación: PrestaShop incluye una herramienta de reparación de base de datos en /install/ (accede a tu-tienda.com/install/). Sigue las instrucciones para intentar reparar la base de datos.
Restaura la copia: Si la reparación no funciona, tendrás que restaurar la copia de seguridad de la base de datos y volver a intentar la actualización, esta vez asegurándote de que la conexión sea estable.

[WARNING] Si usas una conexión Wi-Fi inestable, conecta tu ordenador por cable o realiza la actualización directamente desde el servidor mediante SSH para evitar cortes.

Error 9: No actualizar los módulos y temas después de la actualización

Una vez que PrestaShop está actualizado, es posible que los módulos y temas que dejaste desactivados necesiten actualizarse también para funcionar correctamente con la nueva versión.

Cómo solucionarlo

Revisa el administrador de módulos: Ve a Módulos > Módulos y Servicios. Verás una lista de actualizaciones disponibles. Actualiza todos los módulos que tengan una nueva versión.
Actualiza el tema: Si usas un tema de terceros, consulta la página del desarrollador para ver si hay una versión compatible con la nueva versión de PrestaShop.
Prueba todo: Después de actualizar módulos y temas, recorre tu tienda como si fueras un cliente: revisa el carrito, el checkout, las páginas de producto, etc.

[INFO] No todos los módulos necesitan actualizarse, pero es recomendable hacerlo para mantener la seguridad y el rendimiento.

Error 10: Olvidarse de la seguridad después de actualizar

Después de la actualización, es tentador celebrarlo y olvidarse del tema. Sin embargo, la seguridad es un proceso continuo y hay que revisar algunos puntos.

Cómo solucionarlo

Cambia las contraseñas: Cambia las contraseñas de administrador y de la base de datos.
Elimina la carpeta /install/: Esta carpeta es un riesgo de seguridad grave. Bórrala o renómbrala después de la actualización.
Revisa los permisos: Vuelve a poner los permisos estándar en las carpetas que modificaste durante la actualización.
Actualiza las copias de seguridad: Haz una nueva copia de seguridad de la tienda actualizada para tener un punto de restauración limpio.

[WARNING] La carpeta /install/ es la puerta de entrada favorita de los atacantes. Elimínala siempre después de cualquier actualización o instalación.

Preguntas frecuentes (FAQ)

¿Cuánto tiempo tarda una actualización de PrestaShop?

Depende del tamaño de la tienda y del número de módulos. Una tienda pequeña puede tardar entre 15 y 30 minutos, mientras que una tienda grande con muchos productos y módulos puede tardar varias horas.

¿Puedo actualizar PrestaShop desde el panel de administración?

Sí, PrestaShop tiene un asistente de actualización automática que puedes usar desde el panel de administración. Sin embargo, es recomendable hacerlo manualmente si tienes experiencia, ya que te da más control sobre el proceso.

¿Qué hago si la actualización falla y no tengo copia de seguridad?

Esta es una situación complicada. Puedes intentar contactar con un profesional o con el soporte técnico de tu hosting, pero las posibilidades de recuperar la tienda sin una copia de seguridad son reducidas. Por eso es tan importante hacer siempre una copia antes de actualizar.

¿Debo actualizar PrestaShop a la última versión siempre?

No necesariamente. Las versiones de soporte a largo plazo (LTS) son más estables y reciben actualizaciones de seguridad durante más tiempo. Evalúa si necesitas las nuevas funcionalidades o si prefieres la estabilidad de una versión consolidada.

¿Puedo actualizar PrestaShop desde Syspanel?

Syspanel (el panel de control que se accede por el puerto 2106) no incluye una herramienta específica para actualizar PrestaShop, pero sí te permite gestionar los archivos, la base de datos y los permisos necesarios para hacerlo manualmente. Es una herramienta muy útil para preparar el servidor antes de la actualización.

Conclusión: la paciencia es la clave

Actualizar PrestaShop no es una tarea difícil, pero requiere método y paciencia. La mayoría de los errores que hemos visto se pueden evitar con una buena preparación y siguiendo los pasos en el orden correcto. Recuerda: copia de seguridad, comprobar requisitos, actualizar progresivamente, desactivar módulos incompatibles y limpiar la caché. Si tienes dudas, no dudes en consultar la documentación oficial o buscar ayuda en los foros de la comunidad.

[TIP] Si no te sientes seguro haciendo la actualización tú mismo, siempre puedes contratar un servicio de actualización profesional. Es una inversión que te ahorrará tiempo y dolores de cabeza.