Errores al actualizar PrestaShop y soluciones (2024)

Actualizar PrestaShop es una de las tareas más importantes para mantener tu tienda segura, rápida y con las últimas funciones. Sin embargo, también es uno de los momentos donde más quebraderos de cabeza surgen. Si estás aquí, probablemente te hayas topado con algún problema durante el proceso. No te preocupes, es más común de lo que crees.

En esta guía extensa, vamos a desglosar los errores actualizar PrestaShop más habituales, explicando por qué ocurren y, lo más importante, cómo solucionarlos paso a paso. Olvídate del pánico; vamos a convertirte en un experto en resolver estos contratiempos.

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

Antes de entrar en materia, es útil entender la raíz del problema. PrestaShop es un software complejo que interactúa con un servidor, una base de datos y cientos de módulos y temas. Cuando actualizas la versión, estás cambiando los cimientos de la casa sin derribarla del todo. Un simple archivo incompatible o un ajuste de PHP desactualizado puede provocar un efecto dominó.

Los errores más comunes suelen deberse a tres causas principales:

Entorno del servidor desactualizado: La versión de PHP, MySQL o las configuraciones del servidor no cumplen con los requisitos de la nueva versión de PrestaShop.
Módulos o temas incompatibles: Desarrollados para versiones antiguas, no entienden el nuevo código y generan conflictos.
Permisos de archivos incorrectos: El servidor no tiene permiso para leer, escribir o sobrescribir los archivos necesarios durante la instalación.

Vamos a ver cada error en detalle y su solución.

1. PrestaShop página en blanco (El temido "White Screen of Death")

Este es, sin duda, el error más frustrante. Terminas la actualización, intentas acceder a tu tienda o al panel de administración y... nada. Una pantalla completamente blanca. No hay mensajes, no hay código de error, solo silencio.

¿Qué lo causa?

La PrestaShop página en blanco (también conocida como WSOD) ocurre casi siempre por un error fatal de PHP que está siendo suprimido. Es decir, el código encuentra un problema, pero la configuración del servidor está ocultando el mensaje de error para no mostrar detalles "feos" a los visitantes.

Las causas más frecuentes son:

Límite de memoria (Memory Limit) agotado: El nuevo código requiere más memoria de la que tu servidor permite.
Módulo conflictivo: Uno de tus módulos activos está lanzando una excepción que detiene la ejecución de todo el script.
Archivos de caché corruptos: La caché de Smarty (el motor de plantillas) guardó datos de la versión anterior y ahora no sabe cómo procesar los nuevos.

Cómo solucionarlo

Vamos a desglosar la solución en pasos lógicos. No necesitas ser un programador, solo seguir el orden.

Paso 1: Activar el modo de depuración (Debug Mode)

Necesitamos ver el error oculto. PrestaShop tiene un modo de depuración que muestra los errores en pantalla.

Accede a tu servidor mediante FTP o el administrador de archivos de tu hosting.
Busca el archivo config/defines.inc.php en la raíz de tu instalación de PrestaShop.
Ábrelo con un editor de texto plano (como el Bloc de notas o Sublime Text).
Busca la línea que dice define('_PS_MODE_DEV_', false);.
Cámbiala a define('_PS_MODE_DEV_', true);.
Guarda el archivo y súbelo de nuevo al servidor.

Ahora, recarga tu tienda. En lugar de la pantalla blanca, verás un mensaje de error en inglés o español que dice algo como "Fatal error: Uncaught Error: Call to undefined function...". Anota ese mensaje, es tu mapa del tesoro.

[WARNING] Recuerda cambiar este valor de vuelta a false (o mejor, eliminarlo) una vez hayas solucionado el problema. Dejarlo activo en producción es un riesgo de seguridad.

Paso 2: Aumentar el límite de memoria de PHP

Si el error menciona "Allowed memory size of X bytes exhausted", el problema es la memoria.

Localiza el archivo settings.inc.php en la carpeta config/.
Añade o modifica esta línea al final del archivo:

ini_set('memory_limit', '512M');

También puedes intentar hacerlo desde el archivo .htaccess en la raíz, añadiendo:

php_value memory_limit 512M

Paso 3: Forzar la regeneración de la caché

A veces, el problema no es de código, sino de "basura" acumulada.

Con un cliente FTP, navega a la carpeta var/cache (o cache en versiones antiguas) y dentro de ella a la carpeta prod o dev.
Elimina todo el contenido de estas carpetas (no las carpetas en sí, solo los archivos que hay dentro).
Vuelve a cargar tu tienda. Si no funciona, repite el proceso pero esta vez con la carpeta cache/class_index.php y cache/classes si existen.

[TIP] Si no tienes acceso FTP, puedes intentar activar el modo de mantenimiento desde la base de datos, pero es más complicado. El FTP es la vía más rápida.

2. Error 500 PrestaShop (Error Interno del Servidor)

El error 500 PrestaShop es otro clásico. A diferencia de la pantalla blanca, este suele mostrar un mensaje genérico de "Error interno del servidor". Es la forma que tiene el servidor de decir "algo ha ido muy mal, pero no te voy a dar detalles".

¿Qué lo causa?

Un error 500 puede ser causado por:

Errores de sintaxis en archivos modificados: Si has editado algún archivo del tema o un módulo manualmente y has cometido un error tipográfico, el servidor no puede procesarlo.
Problemas con el archivo .htaccess: Este archivo controla las reglas de reescritura de URL. Si se corrompe durante la actualización, todo se rompe.
Permisos de archivos incorrectos: Si los archivos son propiedad de otro usuario o tienen permisos demasiado restrictivos (por ejemplo, 644 en lugar de 755 para carpetas), el servidor no puede ejecutarlos.

Cómo solucionarlo

Aquí no hay una única solución mágica, sino un proceso de eliminación.

Paso 1: Revisar los logs de error del servidor

Esta es la forma más profesional y rápida. Accede al panel de control de tu hosting (cPanel, Plesk, o Syspanel si usas un hosting gestionado con este panel; recuerda que el puerto de acceso es el 2106). Busca la sección "Registros de errores" o "Error Logs". Ahí verás la causa exacta del error 500.

Busca la última línea que mencione "prestashop" o "public_html". Te dirá el archivo y la línea exacta del problema.

Paso 2: Regenerar el archivo .htaccess

Este archivo se regenera fácilmente.

Ve a la carpeta raíz de tu PrestaShop.
Descarga el archivo .htaccess a tu ordenador como copia de seguridad.
Elimina el archivo .htaccess del servidor.
Ve a tu panel de administración de PrestaShop (si puedes acceder). Si no, tendrás que hacerlo por FTP.
En el panel, ve a Parámetros Avanzados > Rendimiento y haz clic en el botón "Guardar" sin cambiar nada. Esto debería regenerar el archivo .htaccess.

Si no puedes acceder al panel, crea un archivo .htaccess vacío en la raíz y luego intenta acceder. A veces, con un archivo vacío, PrestaShop lo regenera automáticamente al cargar la página.

Paso 3: Verificar los permisos de archivos y carpetas

Los permisos correctos son:

Carpetas: 755
Archivos: 644

Puedes hacerlo desde tu cliente FTP seleccionando todos los archivos y cambiando los permisos. Si usas Syspanel, busca la herramienta "Administrador de archivos" y ahí tendrás la opción de cambiar permisos de forma masiva.

3. Actualización PrestaShop falla: Error en la base de datos

Este es otro de los errores actualizar PrestaShop más temidos. El proceso de actualización se queda a mitad, muestra un mensaje de error en SQL y se detiene. A partir de aquí, tu tienda puede estar en un estado "intermedio" y no funcionar bien.

¿Qué lo causa?

Base de datos corrupta: Antes de actualizar, tu base de datos tenía errores o tablas incompletas.
Versión de MySQL desactualizada: La nueva versión de PrestaShop requiere funciones SQL que tu versión de MySQL no soporta.
Colisión de datos: Algún módulo o personalización ha creado una tabla o columna que ahora entra en conflicto con la nueva estructura.

Cómo solucionarlo

Paso 1: Restaurar la copia de seguridad

Esta es la solución más segura. Si tienes una copia de seguridad reciente de tu base de datos (y deberías tenerla siempre antes de actualizar), restáurala.

Ve a tu panel de administración de la base de datos (phpMyAdmin o la herramienta de Syspanel).
Importa el archivo .sql de tu copia de seguridad.
Una vez restaurada, tu tienda volverá al estado anterior a la actualización.

[WARNING] Este proceso sobrescribirá cualquier cambio realizado después de la copia de seguridad. Asegúrate de que es la copia correcta.

Paso 2: Ejecutar el actualizador de nuevo

A veces, el error es un fallo puntual. Tras restaurar la base de datos, vuelve a intentar la actualización. Si falla en el mismo punto, anota la consulta SQL exacta que aparece en el error. Puedes intentar ejecutarla manualmente en phpMyAdmin, pero esto es avanzado y arriesgado.

Paso 3: Optimizar las tablas de la base de datos

Antes de reintentar, es buena idea optimizar las tablas.

Entra en phpMyAdmin.
Selecciona tu base de datos de PrestaShop.
Marca todas las tablas (clic en "Seleccionar todo").
En el menú desplegable, elige "Optimizar tabla".

Esto repara posibles errores de almacenamiento y puede hacer que la actualización avance.

4. Módulos y temas incompatibles tras la actualización

Una vez que la actualización se completa, es posible que el front-office (tu tienda) se vea roto o que el back-office (panel de administración) muestre errores en módulos específicos.

¿Qué lo causa?

Los módulos y temas de terceros son el pan de cada día de PrestaShop. Los desarrolladores no siempre actualizan sus productos al mismo ritmo que el core de PrestaShop. Tras una actualización, un módulo puede estar usando funciones obsoletas que ya no existen.

Cómo solucionarlo

Paso 1: Identificar el módulo problemático

En el panel de administración, ve a Módulos > Módulos y Servicios. Busca cualquier módulo que muestre un aviso de "incompatible" o que aparezca en rojo.

Paso 2: Desactivar y actualizar

Desactiva el módulo problemático.
Ve al marketplace de PrestaShop o a la web del desarrollador y busca una versión actualizada del módulo.
Descárgala e instálala manualmente (subiendo el archivo ZIP).

Paso 3: Revertir a un tema por defecto

Si el problema es de tu tema personalizado, la solución temporal es cambiar al tema por defecto de PrestaShop (por ejemplo, "Classic").

Ve a Diseño > Tema y Logo.
En la sección "Temas", busca el tema por defecto y haz clic en "Activar".

Esto te dirá si el problema es del tema o de otra cosa. Si con el tema por defecto todo funciona, deberás contactar al desarrollador del tema para que lo actualice.

5. Problemas con los enlaces permanentes (URLs)

Después de actualizar, algunos enlaces de tus productos o categorías pueden devolver un error 404.

¿Qué lo causa?

El cambio en la estructura de las URLs o la regeneración del .htaccess puede romper las reglas de reescritura.

Cómo solucionarlo

Ve a Parámetros Avanzados > SEO y URLs.
Haz clic en el botón "Guardar" sin cambiar nada. Esto fuerza la regeneración de las URLs y el .htaccess.
Si el problema persiste, ve a Parámetros de la tienda > Mantenimiento y desactiva la "URL simplificada" (o al revés, actívala). Guarda y luego vuelve a cambiarla. Esto suele reescribir las URLs correctamente.

FAQ: Preguntas rápidas para resolver dudas comunes

P: ¿Cuánto tiempo tarda la actualización de PrestaShop?
R: Depende del tamaño de tu tienda y de la velocidad del servidor. Puede ir de 5 minutos a 30 minutos. No interrumpas el proceso jamás.

P: ¿Puedo actualizar desde una versión muy antigua (ej. 1.6) a la última (8.x) directamente?
R: No se recomienda. Lo ideal es hacerlo paso a paso (1.6 -> 1.7 -> 8.x). Si intentas un salto grande, es muy probable que la actualización PrestaShop falla por incompatibilidades.

P: ¿Qué hago si no tengo acceso al panel de administración?
R: Aplica las soluciones de la "pantalla en blanco" y el "error 500". Activar el modo debug y revisar los logs es tu mejor opción.

P: ¿Es necesario hacer una copia de seguridad antes de actualizar?
R: SÍ, SIEMPRE. Es la regla de oro. Debes hacer una copia de seguridad de los archivos (por FTP) y de la base de datos (por phpMyAdmin). Si algo sale mal, es tu única tabla de salvación.

P: ¿El hosting influye en los errores?
R: Absolutamente. Un hosting con PHP desactualizado o con límites de memoria bajos es la causa número uno de errores. Asegúrate de que tu hosting cumple con los requisitos de la versión a la que quieres actualizar. Si usas un panel como Syspanel, verifica que tienes la opción de seleccionar la versión de PHP adecuada (7.4, 8.0, 8.1, etc.) en la sección de "PHP Configuration".

Conclusión: La paciencia es tu mejor aliada

Actualizar PrestaShop no tiene por qué ser una pesadilla. La mayoría de los errores tienen solución y, con esta guía, ya sabes por dónde empezar a buscar. Recuerda siempre:

Haz copias de seguridad.
Revisa los requisitos del servidor (PHP y MySQL).
Actualiza módulos y temas a sus versiones más recientes antes de actualizar el core.
No te saltes pasos y ve con calma.

Si te encuentras con PrestaShop página en blanco o un error 500 PrestaShop, respira hondo, activa el modo debug y sigue los pasos de esta guía. La solución casi siempre está a un clic de distancia. ¡Buena suerte con tu actualización!