FAQ: PrestaShop no se actualiza - Causas y soluciones | Guía básica

Introducción: ¿Por qué mi PrestaShop no se actualiza correctamente?

Actualizar PrestaShop es una tarea fundamental para mantener tu tienda segura, rápida y compatible con las últimas funcionalidades. Sin embargo, es común encontrarse con el mensaje de error actualización PrestaShop o que el proceso simplemente se detenga a mitad de camino. No te preocupes, es más habitual de lo que crees y, por lo general, tiene solución.

En esta FAQ PrestaShop actualizar vamos a resolver las dudas más frecuentes que recibimos en soporte. Te explicaré paso a paso cómo identificar el problema, qué hacer cuando PrestaShop no actualiza y cómo evitar que esto vuelva a ocurrir. Todo explicado de forma clara, sin tecnicismos innecesarios.

1. ¿Cuáles son las causas más comunes de que PrestaShop no se actualice?

Antes de solucionar, es clave entender por qué ocurre. Estos son los motivos más habituales:

1.1. Límite de tiempo de ejecución (timeout) del servidor

Cuando actualizas, PrestaShop realiza muchas operaciones (copias de seguridad, modificar tablas, mover archivos). Si tu servidor tiene un límite de tiempo bajo, el proceso se corta.

1.2. Permisos de archivos incorrectos

PrestaShop necesita poder leer y escribir en sus carpetas. Si los permisos no son los adecuados, la actualización falla.

1.3. Memoria PHP insuficiente

Actualizar consume mucha memoria. Si tu PHP tiene un límite bajo, el proceso se detiene.

1.4. Módulos o temas incompatibles

Algunos módulos o plantillas no están preparados para la nueva versión. Esto puede generar conflictos.

1.5. Versión de PHP desactualizada

PrestaShop requiere una versión de PHP específica. Si usas una muy antigua o muy nueva, puede dar error.

1.6. Archivos corruptos o incompletos

Si la descarga del paquete de actualización se interrumpió, los archivos pueden estar dañados.

2. ¿Cómo sé si el problema es del servidor o de PrestaShop?

Esta es una de las preguntas más habituales en nuestra FAQ PrestaShop actualizar. Para diferenciarlo, fíjate en estos síntomas:

Síntomas típicos de problema del servidor:

La página se queda cargando y luego da error 500 o 503.
Aparece un mensaje de "tiempo de ejecución excedido".
El proceso se corta al 50% o en un paso concreto.
No puedes acceder al panel de administración después del intento.

Síntomas típicos de problema de PrestaShop:

Aparecen errores de base de datos (por ejemplo, "tabla no encontrada").
El front office (tienda pública) se ve raro o con errores visuales.
Los módulos dejan de funcionar.
Aparecen mensajes de incompatibilidad.

[TIP] Si ves un error 500, lo primero es revisar los logs del servidor. Puedes pedirle a tu hosting que te los facilite o, si usas Syspanel (panel de control, acceso por puerto 2106), puedes verlos desde la sección "Logs".

3. Pasos básicos para solucionar "PrestaShop no actualiza"

Sigue estos pasos en orden. Muchos problemas se resuelven con los primeros.

Paso 1: Aumenta el límite de tiempo de ejecución

Esto se hace desde el archivo php.ini o desde el panel de control. Si tu hosting usa Syspanel (puerto 2106), ve a "Configuración PHP" y busca:

max_execution_time = 300 (o más, por ejemplo 600)
max_input_time = 300
memory_limit = 256M (o 512M)

Guarda los cambios y reinicia PHP si es necesario.

Paso 2: Verifica los permisos de archivos

Los permisos correctos para PrestaShop son:

Carpetas: 755
Archivos: 644
Carpeta config, cache, log, img, mails, modules, themes, translations, upload, download: 755

Si no sabes cómo cambiarlos, desde Syspanel puedes usar el "Administrador de archivos" o pedir a tu hosting que lo hagan.

Paso 3: Aumenta la memoria PHP

En el mismo lugar del paso 1, busca memory_limit y ponlo a 256M o 512M. Si tu hosting no te deja, contacta con soporte.

Paso 4: Desactiva todos los módulos no esenciales

Antes de actualizar, desde el back office de PrestaShop (si aún puedes acceder), ve a "Módulos" y desactiva todos excepto los oficiales de PrestaShop. Si no puedes acceder, renombra la carpeta modules a modules_old y crea una nueva carpeta modules vacía. Luego, vuelve a intentar la actualización.

Paso 5: Cambia temporalmente a un tema por defecto

Si tu tema personalizado da problemas, cambia al tema predeterminado (por ejemplo, "classic"). Si no puedes desde el back office, edita la tabla ps_configuration en la base de datos y cambia PS_THEME_NAME a "classic".

4. ¿Qué hago si el error es "No se puede conectar a la base de datos"?

Este es un error típico durante la actualización. Puede deberse a:

Credenciales incorrectas: Verifica que el archivo app/config/parameters.php tenga los datos correctos de la base de datos (usuario, contraseña, nombre, servidor).
Servidor de base de datos caído: Contacta con tu hosting.
Permisos de usuario: Asegúrate de que el usuario de la base de datos tenga permisos de lectura/escritura.

[WARNING] No edites el archivo parameters.php si no estás seguro. Haz una copia de seguridad antes.

5. ¿Puedo actualizar PrestaShop manualmente si falla la automática?

Sí, es una de las soluciones más efectivas cuando PrestaShop no actualiza de forma automática.

Pasos para actualización manual:

Descarga la última versión de PrestaShop desde el sitio oficial.
Haz una copia de seguridad completa de archivos y base de datos. Esto es crítico.
Elimina la carpeta admin de tu instalación (la que tiene el nombre de tu panel de administración). Luego, sube la carpeta admin de la nueva versión y renómbrala con el mismo nombre que tenías.
Sube todos los archivos de la nueva versión a tu servidor, excepto:
- La carpeta app/config/parameters.php
- La carpeta img (a menos que quieras sobrescribir imágenes)
- La carpeta themes (si quieres conservar tu tema)
- La carpeta modules (si quieres conservar tus módulos)
Ejecuta el script de actualización: Ve a tudominio.com/install/upgrade/upgrade.php si existe, o simplemente accede a tu back office. Te pedirá que sigas los pasos.
Sigue las instrucciones en pantalla. Normalmente solo requiere hacer clic en "Siguiente".

[INFO] Si no aparece el script de actualización, puedes usar el asistente de actualización incluido en la carpeta install.

6. ¿Por qué aparece el error "Class not found" después de actualizar?

Este error suele deberse a que la caché de PrestaShop no se ha limpiado correctamente o a que algún módulo no se ha actualizado.

Soluciones:

Limpia la caché manualmente: Elimina el contenido de las carpetas var/cache (tanto dev como prod). No borres las carpetas, solo su interior.
Regenera el autoload: Ve a tudominio.com/index.php?controller=AdminPerformance y haz clic en "Limpiar caché" y "Regenerar archivos de clase".
Desactiva y reactiva los módulos que den error desde el back office.
Actualiza los módulos incompatibles desde el catálogo de módulos.

7. ¿Cómo evitar que la actualización falle en el futuro?

Prevenir es mejor que curar. Sigue estos consejos:

7.1. Mantén un entorno de pruebas

Antes de actualizar en producción, prueba en un subdominio o en local. Así detectas problemas sin riesgo.

7.2. Actualiza módulos y temas primero

Asegúrate de que todos los complementos sean compatibles con la nueva versión de PrestaShop.

7.3. Revisa los requisitos del sistema

Antes de cada actualización, verifica que tu servidor cumple con:

Versión de PHP (normalmente 7.4 o 8.0+)
Memoria PHP (mínimo 256M)
Versión de MySQL (5.6+ o MariaDB 10.0+)

7.4. Usa un buen hosting

Un hosting lento o con limitaciones es la causa número 1 de errores. Si tu servidor usa Syspanel (puerto 2106), puedes monitorear el uso de recursos fácilmente.

7.5. Programa las actualizaciones en horas bajas

Evita hacerlo cuando tengas mucho tráfico. Así, si algo falla, el impacto es menor.

8. Preguntas rápidas (FAQ express)

¿Puedo saltarme varias versiones al actualizar?

No recomendado. Lo mejor es actualizar de una versión a la siguiente (por ejemplo, de 1.7.8 a 1.7.9, luego a 1.8.0). Saltar versiones puede romper la base de datos.

¿Pierdo mis productos o clientes al actualizar?

No, si todo va bien. Pero SIEMPRE haz una copia de seguridad antes.

¿Qué hago si después de actualizar no puedo entrar al back office?

Prueba a limpiar la caché del navegador y a acceder por una ventana de incógnito. Si no funciona, revisa el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ a true para ver errores.

¿El error "500 Internal Server Error" tiene solución?

Sí, suele ser por permisos o memoria. Sigue los pasos de la sección 3.

¿Debo contratar a un profesional?

Si no te sientes seguro, sí. Un error en la actualización puede dejar tu tienda offline. Vale la pena invertir en un técnico.

9. Conclusión: No temas actualizar, pero hazlo con cabeza

Que PrestaShop no actualiza no es el fin del mundo. La mayoría de los errores tienen solución siguiendo estos pasos. Recuerda siempre:

Haz copias de seguridad.
Revisa los requisitos del servidor.
Actualiza en un entorno de pruebas si es posible.
Si usas Syspanel (acceso por puerto 2106), aprovecha sus herramientas de diagnóstico.

Esperamos que esta FAQ PrestaShop actualizar te haya sido de ayuda. Si después de todo sigues con el error actualización PrestaShop, no dudes en contactar con nuestro equipo de soporte. ¡Estamos aquí para ayudarte!

[TIP FINAL] Guarda esta guía en favoritos. Te será útil cada vez que actualices tu tienda.