Errores al actualizar PrestaShop | Soluciones

Antes de empezar: La regla de oro de las actualizaciones

Actualizar PrestaShop es como hacer una mudanza: emocionante por lo nuevo, pero con riesgo de romper algo por el camino. La mayoría de los problemas que verás a continuación se evitan con una simple acción: hacer una copia de seguridad completa (archivos y base de datos) antes de tocar nada. Si ya estás en medio del caos y no tienes copia, no desesperes, que aquí te traemos la solución a los errores más comunes.

Un segundo consejo vital: actualiza siempre a la última versión disponible, pero de una en una. Si tienes PrestaShop 1.6 y quieres llegar a la 8.x, no saltes directamente. Ve de la 1.6 a la 1.7, y luego a la 8. Esto reduce muchísimo los conflictos.

Error 500 PrestaShop: El más temido y el más común

El famoso error 500 prestashop es la pesadilla de cualquier administrador. La pantalla se queda en blanco o muestra un mensaje genérico de error interno del servidor. Pero no te asustes, casi siempre tiene una solución clara.

¿Por qué aparece el error 500 al actualizar?

Este error significa que el servidor no puede procesar la petición. Tras una actualización, suele deberse a tres causas principales:

Archivos de caché corruptos: Los archivos de caché de versiones anteriores pueden entrar en conflicto con los nuevos.
Incompatibilidad de PHP: La nueva versión de PrestaShop requiere una versión de PHP más moderna que la que tienes en tu hosting.
Módulos o temas incompatibles: Un módulo antiguo que no se ha actualizado puede provocar un fallo fatal en todo el sistema.

Solución paso a paso al Error 500

Sigue este orden, del más simple al más complejo:

Limpia la caché manualmente: Accede a tu hosting por FTP o al administrador de archivos. Borra todo el contenido de la carpeta /var/cache/ (en PrestaShop 1.7 y superiores) o /cache/ (en versiones antiguas). No borres la carpeta, solo su contenido.
Activa el modo de depuración (Debug): Esto te mostrará el error real en lugar de la pantalla blanca. Abre el archivo /config/defines.inc.php y busca la línea define('_PS_MODE_DEV_', false);. Cámbiala a true. Guarda y recarga la tienda. Verás un mensaje con el error específico.
Revisa la versión de PHP: Entra en el panel de control de tu hosting y cambia la versión de PHP a una recomendada por PrestaShop (normalmente PHP 7.4, 8.0 o 8.1, dependiendo de la versión de PrestaShop). Si usas Syspanel (accesible a través del puerto 2106), busca la sección de "PHP" o "Gestor de aplicaciones" para cambiarlo fácilmente.
Desactiva módulos problemáticos: Si el error menciona un módulo concreto, renombra la carpeta del módulo desde FTP (por ejemplo, de ps_googleanalytics a ps_googleanalytics_old). Esto lo desactiva sin pasar por el panel de administración.
Sube de nuevo los archivos: A veces la actualización se corrompe. Vuelve a subir los archivos de la versión actual de PrestaShop, sobrescribiendo los existentes, pero sin tocar la carpeta config/, img/ ni themes/ si no quieres perder tu configuración.

[WARNING] Si activas el modo debug, no olvides desactivarlo (volver a poner false) cuando termines. Dejarlo activo en producción es un riesgo de seguridad grave.

Actualizar PrestaShop falla: El asistente de actualización no avanza

Otro de los grandes quebraderos de cabeza es que el proceso se quede atascado a mitad de camino. El asistente de actualización se congela, da error de tiempo de espera o simplemente se reinicia solo.

Causas de que la actualización de PrestaShop falle a mitad

Esto ocurre principalmente por dos motivos:

Límite de memoria PHP (memory_limit): El proceso de actualización consume muchos recursos. Si el límite es bajo, se corta.
Tiempo máximo de ejecución (max_execution_time): El servidor corta la ejecución del script si tarda demasiado.

Cómo solucionar el fallo en la actualización de PrestaShop

Aumenta la memoria PHP: Crea un archivo llamado php.ini en la raíz de tu tienda y añade esta línea: memory_limit = 512M. También puedes añadir max_execution_time = 300 para dar más tiempo al proceso.
Aumenta el tiempo de ejecución en el archivo .htaccess: Si no puedes crear el php.ini, añade al final del archivo .htaccess (en la raíz) estas líneas:
```
<IfModule mod_php7.c>
    php_value memory_limit 512M
    php_value max_execution_time 300
</IfModule>
```
Desactiva la caché de opcache: Entra en el panel de tu hosting y desactiva "OPcache" temporalmente durante la actualización. Este acelerador de PHP a veces guarda versiones antiguas de los archivos y provoca conflictos.
Usa el actualizador manual: Si el asistente se sigue quedando colgado, descarga el módulo "1-Click Upgrade" y súbelo manualmente a la carpeta /modules/. Luego, intenta la actualización desde el panel de administración.

[TIP] Si tu hosting usa Syspanel, dentro del puerto 2106 puedes encontrar los ajustes de PHP y opcache en la sección "Servicios" o "PHP". Es mucho más cómodo que editar archivos a mano.

El error de la base de datos: "ALTER TABLE" o "Duplicate column"

Es muy común que tras una actualización aparezcan errores de SQL, especialmente mensajes como #1060 - Duplicate column name o #1054 - Unknown column. Esto significa que la base de datos no se ha actualizado correctamente o que hay restos de versiones anteriores.

Solución a errores de base de datos en PrestaShop

Identifica el error exacto: Activa el modo debug (como vimos antes) para ver la consulta SQL que falla.
Ejecuta la consulta manualmente: Con la consulta delante, entra en phpMyAdmin (desde Syspanel o tu panel de hosting), selecciona la base de datos de tu tienda y ejecuta esa consulta directamente en la pestaña "SQL".
Revisa las tablas de módulos: A veces, el error viene de una tabla de un módulo que no se ha actualizado. Si el error menciona una tabla de un módulo específico, considera desactivar ese módulo y volver a intentarlo.
Utiliza la herramienta de reparación de PrestaShop: En el módulo "1-Click Upgrade", en sus parámetros avanzados, existe una opción para "Reactivar la base de datos". Úsala para que el sistema intente reparar los desajustes.

[INFO] No intentes borrar tablas o columnas a lo loco. Una mala ejecución de SQL puede cargarse toda la tienda. Si no estás seguro, pide ayuda a tu hosting o a un desarrollador.

El problema de los módulos y temas tras la actualización

Es la causa más frecuente de que actualizar prestashop falla o de que la tienda se vea "rara" después del proceso. Los módulos y temas de terceros suelen quedarse obsoletos.

¿Cómo sé si un módulo es el culpable?

Síntomas: La tienda muestra errores, se ve sin estilos (HTML sin CSS) o te redirige a una página de error.
Detección: Ve a "Módulos" > "Módulos y servicios" en el panel de administración. Busca los que estén marcados como "Incompatibles" o "Desactualizados".
Solución: Actualiza los módulos uno a uno. Si no tienen actualización, contacta con el desarrollador. Si el problema es urgente, desactívalos hasta que haya una solución.
Tema: Si el problema es del tema, cambia temporalmente al tema por defecto de PrestaShop (por ejemplo, "Classic"). Si la tienda funciona bien, el problema es del tema. Deberás ponerte en contacto con su desarrollador para que lo adapte.

El error de "La tienda está en modo de mantenimiento"

A veces, después de una actualización, la tienda se queda en modo mantenimiento y no puedes desactivarlo desde el panel porque te da error o no te deja entrar.

Salir del modo mantenimiento forzado

Desde la base de datos: Entra en phpMyAdmin, busca la tabla ps_configuration (el prefijo ps_ puede variar) y busca la variable PS_SHOP_ENABLE. Cambia su valor de 0 a 1. Guarda los cambios.
Desde el archivo de configuración: En la raíz de tu PrestaShop, abre el archivo app/config/parameters.php. Busca la línea 'PS_SHOP_ENABLE' => 0 y cámbiala a 'PS_SHOP_ENABLE' => 1. Guarda el archivo.

[TIP] Si no encuentras la variable en parameters.php, es que está en la base de datos. El método de phpMyAdmin es el más fiable.

El error de los enlaces o URLs rotas

Tras una actualización, las URLs pueden cambiar de formato o dar error 404. Esto es porque la "rewrite" de las URLs no se ha regenerado.

Solución para URLs rotas

Ve a "Parámetros avanzados" > "SEO y URLs" en el panel de administración.
Haz clic en "Guardar" sin cambiar nada. Esto fuerza a PrestaShop a regenerar las reglas de reescritura.
Si el problema persiste, borra la caché de nuevo y asegúrate de que el archivo .htaccess tiene permisos de escritura (normalmente 644 o 755).

Preguntas Frecuentes (FAQ) sobre errores de actualización

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

Normalmente, entre 10 y 30 minutos, dependiendo del tamaño de la tienda y de la velocidad del servidor. Si tarda más de una hora, algo está fallando.

¿Puedo volver a la versión anterior si algo sale mal?

Sí, si tienes una copia de seguridad completa (archivos y base de datos). Simplemente restaura la copia y la tienda volverá a estar como antes. Por eso es tan importante la copia de seguridad inicial.

¿Qué hago si no tengo acceso al panel de administración?

Si no puedes entrar al panel, tendrás que trabajar por FTP y phpMyAdmin. Puedes desactivar módulos renombrando sus carpetas, cambiar la versión de PHP desde tu hosting y, si es necesario, restaurar la copia de seguridad.

¿Es lo mismo actualizar que migrar PrestaShop?

No. Actualizar es pasar de una versión a otra (ej. de 1.7 a 8.0). Migrar es cambiar de servidor o de dominio, manteniendo la misma versión. Los errores son diferentes, aunque algunos consejos son comunes.

¿Necesito contratar a un profesional para actualizar?

Si tu tienda es pequeña, puedes intentarlo tú con esta guía. Si tienes muchos módulos personalizados o un tema complejo, es recomendable contratar a un experto para que te ahorre dolores de cabeza.

Conclusión final: La paciencia y la preparación son tus aliadas

Los errores actualizar prestashop son tan comunes que hasta los desarrolladores más experimentados se los encuentran. La clave está en no entrar en pánico y seguir un método lógico: primero la caché, luego el PHP, después los módulos y por último la base de datos.

Recuerda siempre tener una copia de seguridad a mano, usar el modo debug para ver los errores reales y actualizar poco a poco. Con estos pasos, tu tienda estará funcionando con la nueva versión en un abrir y cerrar de ojos. Y si te sientes perdido, no dudes en contactar con el soporte de tu hosting: para eso están.