Errores actualización PrestaShop | Soluciones 2025

Actualizar PrestaShop es una tarea necesaria para mantener la seguridad, el rendimiento y las funcionalidades de tu tienda online. Sin embargo, es un proceso que puede presentar complicaciones si no se realiza con cuidado. Los errores actualizar PrestaShop son más comunes de lo que piensas, y pueden provocar desde una pantalla en blanco hasta la pérdida temporal de datos. En esta guía extensa, te explicaré los fallos más frecuentes, por qué ocurren y, lo más importante, cómo solucionarlos paso a paso.

¿Por qué falla la actualización de PrestaShop?

Antes de entrar en detalles, es bueno entender las causas raíz. La actualización PrestaShop falla principalmente por incompatibilidades entre versiones, módulos desactualizados, límites de servidor o errores en los archivos del core. Muchos de estos problemas se pueden evitar con una buena preparación previa.

Error 1: Pantalla en blanco o "White Screen of Death"

Este es uno de los errores actualizar PrestaShop más frustrantes. Después de la actualización, ves una página completamente en blanco. No hay mensajes, ni códigos, solo silencio.

Causas principales

Módulos o temas incompatibles con la nueva versión.
Errores de PHP (por ejemplo, memoria insuficiente o versiones de PHP no soportadas).
Archivos del core corruptos durante la subida.

Cómo solucionarlo

Accede a tu servidor por FTP o cPanel. Ve a la carpeta /config/ y abre el archivo defines.inc.php.
Busca la línea: define('_PS_MODE_DEV_', false); y cámbiala a define('_PS_MODE_DEV_', true);. Esto activará el modo de desarrollo y mostrará los errores concretos.
Identifica el error. Si ves un mensaje como "Fatal error: Allowed memory size of..." significa que necesitas aumentar la memoria PHP.
Aumenta la memoria PHP. En el archivo defines.inc.php, agrega justo después de la línea anterior: ini_set('memory_limit', '256M'); o incluso 512M.
Desactiva módulos problemáticos. Desde la base de datos (phpMyAdmin), ve a la tabla ps_module y cambia el estado de los módulos recién instalados a 0 (inactivo). O simplemente renombra la carpeta /modules/ a /modules_old/ para desactivarlos todos temporalmente.

[WARNING] No dejes el modo desarrollo activado en producción. Una vez solucionado el error, vuelve a poner false.

Error 2: Error de base de datos durante la actualización

Otro clásico es que el proceso se detenga a mitad de camino con un mensaje como "Error de SQL" o "Tabla no encontrada". Esto sucede porque las consultas de actualización no se ejecutan correctamente.

Causas

Tablas de la base de datos con prefijos personalizados.
Versión de MySQL/MariaDB desactualizada.
Colisiones entre módulos y las nuevas columnas de la base de datos.

Solución paso a paso

Haz un backup completo de la base de datos. Ve a phpMyAdmin, selecciona tu base de datos y elige "Exportar". Guarda el archivo .sql en tu ordenador.
Verifica el prefijo de las tablas. En PrestaShop 1.7, el prefijo por defecto es ps_, pero si lo cambiaste, anótalo.
Ejecuta las consultas manualmente. Si el error indica una tabla específica, por ejemplo ps_product_shop, abre el archivo SQL de actualización (suele estar en /install/upgrade/sql/) y busca esa consulta. Ejecútala manualmente en phpMyAdmin.
Repara la base de datos. En phpMyAdmin, selecciona todas las tablas y en el menú desplegable elige "Reparar tabla". Esto corrige errores menores de estructura.
Reintenta la actualización desde el panel de administración o mediante el script /install/upgrade/upgrade.php.

[INFO] Si la actualización se queda colgada, puedes forzar el reinicio eliminando el archivo /app/Resources/install.lock (si existe) y volviendo a ejecutar el script.

Error 3: Módulos y temas incompatibles

Después de actualizar, algunos módulos dejan de funcionar o muestran errores. Esto es muy común porque los desarrolladores no siempre actualizan sus módulos al mismo ritmo que PrestaShop.

Cómo identificarlos

Ve a Módulos > Catálogo de módulos en el back office.
Busca módulos con la etiqueta "No compatible" o que aparezcan en rojo.
Revisa el log de errores en Parámetros avanzados > Información > Logs.

Soluciones

Actualiza todos los módulos a sus últimas versiones antes de la actualización del core. Si ya actualizaste, hazlo ahora.
Desactiva módulos problemáticos. Si un módulo no tiene actualización, desactívalo temporalmente. Puedes hacerlo desde el back office o directamente en la base de datos (tabla ps_module, columna active = 0).
Cambia a un tema nativo. Temporalmente, activa el tema por defecto (por ejemplo, "Classic" en PrestaShop 1.7) para descartar que el problema sea del tema.
Busca alternativas. Si el módulo es crítico y no se actualiza, considera buscar un sustituto en el marketplace.

[TIP] Siempre verifica la compatibilidad de módulos y temas en la página oficial de PrestaShop antes de actualizar.

Error 4: Límites del servidor (tiempo de ejecución, memoria, subida de archivos)

Muchas veces la actualización PrestaShop falla porque el servidor tiene límites muy bajos. Esto es especialmente común en hosting compartido.

Parámetros críticos

max_execution_time: 30 segundos por defecto. Una actualización grande puede necesitar 300 o más.
memory_limit: 128M suele ser insuficiente. Necesitas al menos 256M.
upload_max_filesize: Si subes el paquete de actualización manualmente, debe ser mayor a 32MB.

Cómo aumentarlos

Crea o edita el archivo php.ini en la raíz de tu instalación de PrestaShop. Si no existe, créalo.

Agrega estas líneas:

max_execution_time = 300
memory_limit = 256M
upload_max_filesize = 64M
post_max_size = 64M

Si usas Syspanel (antes HestiaCP), puedes acceder a la configuración de PHP desde el panel. Ve a Syspanel > Cuentas de usuario > tu dominio > Configuración avanzada > PHP. Ajusta los valores desde allí. Recuerda que el puerto de acceso a Syspanel es el 2106.
Si no puedes modificar php.ini, contacta a tu proveedor de hosting. Muchos permiten cambios desde cPanel o Plesk.

[WARNING] No subas demasiado la memoria si tu servidor tiene recursos limitados. 512M suele ser seguro.

Error 5: Error de permisos de archivos y carpetas

Después de la actualización, puede que veas errores como "No se puede escribir en el archivo" o "Permiso denegado". Esto ocurre cuando los archivos no tienen los permisos correctos.

Solución

Conecta por FTP a tu servidor.
Asegúrate de que todas las carpetas tengan permisos 755 y los archivos 644.
Carpetas especiales: Las carpetas /cache/, /log/, /img/, /upload/ y /download/ deben tener permisos 777 (escritura para todos). Esto es necesario para que PrestaShop pueda generar archivos temporales.

Usa un comando rápido en SSH (si tienes acceso):

find /ruta/a/prestashop -type d -exec chmod 755 {} \;
find /ruta/a/prestashop -type f -exec chmod 644 {} \;
chmod -R 777 cache log img upload download

Limpia la caché desde el back office: Parámetros avanzados > Rendimiento > Limpiar caché.

[INFO] Algunos hosting como Syspanel permiten cambiar permisos desde el gestor de archivos web. Busca la opción "Permisos" al hacer clic derecho en una carpeta.

Error 6: Error al acceder al back office después de la actualización

A veces la tienda se ve bien, pero no puedes entrar al panel de administración. Aparece un error de inicio de sesión o una página en blanco.

Causas

Cookies de sesión corruptas.
Problemas con el archivo settings.inc.php.
URL incorrecta en la configuración.

Soluciones

Limpia las cookies y caché del navegador. Prueba con otro navegador o en modo incógnito.
Verifica el archivo config/settings.inc.php. Asegúrate de que las constantes _COOKIE_KEY_ y _COOKIE_IV_ tengan valores largos y aleatorios. Si están vacías, la sesión no se mantiene.
Reconstruye el archivo de configuración. Si todo falla, puedes descargar el archivo settings.inc.php original de la versión actualizada desde el paquete de instalación y reemplazarlo. Luego vuelve a configurar los datos de conexión a la base de datos (usuario, contraseña, nombre de base de datos, etc.).
Accede directamente al script de actualización: Ve a tudominio.com/install/upgrade/upgrade.php y sigue los pasos. Esto puede reparar la configuración del back office.

[WARNING] Nunca compartas tu _COOKIE_KEY_ porque es la clave de seguridad de las sesiones.

Error 7: Imágenes rotas o productos sin fotos

Después de la actualización, muchas imágenes no se muestran. Esto es porque PrestaShop regenera las miniaturas y a veces el proceso falla.

Solución

Regenera las miniaturas manualmente. Ve a Parámetros avanzados > Rendimiento > Regenerar miniaturas. Selecciona "Imágenes de productos" y haz clic en "Regenerar".
Aumenta el tiempo de ejecución si el proceso se detiene (como vimos en el Error 4).
Verifica los permisos de la carpeta /img/. Debe tener permisos 777.
Si usas CDN, purga la caché de imágenes después de la regeneración.
Como último recurso, sube las imágenes originales de nuevo desde el back office (Catálogo > Productos > editar producto > Imágenes).

Preguntas Frecuentes (FAQ)

¿Puedo saltarme una versión al actualizar?

No se recomienda. PrestaShop está diseñado para actualizaciones secuenciales (por ejemplo, de 1.7.6 a 1.7.7, no de 1.7.6 a 1.7.9). Si lo haces, pueden ocurrir errores de base de datos. Siempre actualiza paso a paso.

¿Qué hago si la actualización se queda colgada en "Actualizando base de datos"?

Espera unos minutos. Si no avanza, revisa el log de errores en /var/log/. Puede ser un problema de tiempo de ejecución. Aumenta max_execution_time a 600 segundos y vuelve a ejecutar el script /install/upgrade/upgrade.php.

¿Debo desactivar la tienda durante la actualización?

Sí, es recomendable. Ve a Parámetros de la tienda > Mantenimiento y activa el modo mantenimiento. Así los clientes no verán errores.

¿Qué pasa si mi hosting usa Syspanel?

Si tu hosting utiliza Syspanel (antes HestiaCP), recuerda que el puerto de acceso es el 2106. Puedes gestionar archivos, bases de datos y configuraciones PHP desde allí. Para la actualización, asegúrate de tener los permisos correctos y los límites de PHP adecuados, como explicamos antes.

¿Es necesario hacer backup antes de actualizar?

Sí, siempre. Haz backup de archivos y base de datos. Si algo sale mal, podrás restaurar tu tienda en minutos.

Resumen final: Checklist para una actualización sin errores

Haz un backup completo (archivos + base de datos).
Verifica la compatibilidad de módulos y temas con la nueva versión.
Aumenta los límites del servidor (memoria, tiempo de ejecución, subida).
Activa el modo mantenimiento.
Actualiza los módulos a sus últimas versiones.
Realiza la actualización usando el asistente de PrestaShop o el script manual.
Limpia la caché y regenera miniaturas.
Prueba la tienda en todos los dispositivos y procesos (carrito, pago, registro).

Si sigues estos pasos, los errores actualizar PrestaShop se reducirán al mínimo. Recuerda que la paciencia y la preparación son tus mejores aliados. ¡Buena suerte con tu actualización!