Solución de errores comunes al actualizar PrestaShop en Plesk

Actualizar PrestaShop en un servidor Plesk puede parecer una tarea sencilla, pero a veces surgen errores que pueden detener el proceso y generar frustración. En esta guía extensa, te explicaremos paso a paso cómo solucionar los errores más comunes al actualizar PrestaShop Plesk, desde problemas de permisos hasta conflictos de módulos o bases de datos. Si estás buscando solución problemas PrestaShop, este artículo es para ti. Lo abordaremos con un lenguaje claro, ejemplos prácticos y recomendaciones para que incluso sin experiencia técnica puedas resolverlo.

Preparación antes de actualizar: la clave del éxito

Antes de comenzar cualquier actualización, es fundamental preparar el entorno. La mayoría de los errores actualización PrestaShop se deben a una mala preparación. Sigue estos pasos previos:

1. Haz una copia de seguridad completa: tanto de los archivos (vía FTP o el administrador de archivos de Plesk) como de la base de datos (desde phpMyAdmin o la herramienta de bases de datos de Plesk). Guarda la copia en tu ordenador o en un almacenamiento externo.
2. Verifica los requisitos del sistema: PrestaShop 8.x requiere PHP 7.4 o superior, MySQL 5.6+ o MariaDB 10.1+ y extensiones como curl, gd, json, mbstring, openssl, pdo_mysql, zip. Desde Plesk puedes cambiar la versión de PHP en Hosting & DNS > PHP Settings.
3. Desactiva la tienda temporalmente: ve a Parámetros de la tienda > Mantenimiento y activa el modo mantenimiento. Esto evitará que los usuarios accedan durante la actualización.
4. Revisa los módulos y temas: asegúrate de que todos los módulos y el tema activo sean compatibles con la nueva versión. Los módulos desactualizados son una de las principales causas de errores actualización PrestaShop.

[TIP] Si usas un panel como Syspanel (accesible por puerto 2106), el proceso es similar: haz copia de seguridad desde el administrador de archivos y la base de datos, y luego cambia la versión de PHP en la configuración del dominio.

Error 1: Pantalla blanca o “500 Internal Server Error” después de la actualización

Este es uno de los problemas más comunes al actualizar PrestaShop Plesk. Suele deberse a un conflicto de PHP, falta de memoria o módulos incompatibles.

Solución paso a paso

1. Habilita la visualización de errores: temporalmente, edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true. Esto mostrará el error real en lugar de la pantalla blanca.
2. Revisa el log de errores: en Plesk, ve a Hosting & DNS > Logs y busca el archivo error_log en la raíz de tu tienda. También puedes consultar el log de PHP desde Herramientas y ajustes > Logs de PHP.
3. Aumenta el límite de memoria PHP: desde PHP Settings en Plesk, incrementa memory_limit a 256M o 512M temporalmente.
4. Desactiva módulos problemáticos: renombra la carpeta modules (por ejemplo, a modules_old) y luego crea una nueva carpeta modules vacía. Si la tienda carga, el problema es un módulo. Reactívalos uno por uno.
5. Verifica la versión de PHP: asegúrate de que estás usando una versión compatible (PHP 7.4 o 8.0 para PrestaShop 8.x). Si usas PHP 8.1 o superior, algunos módulos pueden fallar.

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

Error 2: “El archivo no se puede sobrescribir” o errores de permisos

Al actualizar PrestaShop Plesk, el instalador necesita escribir en carpetas como config, cache, modules, themes, override, upload, download, img, log, translations. Si los permisos son incorrectos, fallará.

Solución

1. Ajusta los permisos desde Plesk: ve a Hosting & DNS > Administrador de archivos, selecciona la carpeta raíz de tu tienda y haz clic en Permisos. Establece 755 para directorios y 644 para archivos. Para las carpetas mencionadas, puedes usar 777 temporalmente (luego vuelve a 755).
2. Usa el comando chown (si tienes acceso SSH): si tu plan lo permite, conecta por SSH y ejecuta:

   chown -R usuario:grupo /ruta/a/tu/tienda
   chmod -R 755 /ruta/a/tu/tienda
   chmod -R 777 /ruta/a/tu/tienda/cache /ruta/a/tu/tienda/config
   

   (Reemplaza usuario:grupo con los datos de tu hosting, que puedes ver en Plesk en Suscripciones > Configuración del hosting).
3. Verifica el propietario de los archivos: en Plesk, el usuario suele ser psacln o el nombre de tu suscripción. Si los archivos pertenecen a otro usuario, el instalador no podrá modificarlos.

[INFO] Si usas Syspanel (puerto 2106), los permisos se configuran desde el administrador de archivos del panel. No olvides que el usuario del sistema suele ser el mismo que el nombre del plan de hosting.

Error 3: “Error de conexión a la base de datos” o problemas con la actualización de la BD

Durante la actualizar PrestaShop Plesk, el script modifica la estructura de la base de datos. Si hay tablas corruptas, colaciones incorrectas o falta de espacio, aparecerá este error.

Solución

1. Repara las tablas desde phpMyAdmin: ingresa a phpMyAdmin desde Plesk (en Bases de datos), selecciona tu base de datos y en la pestaña SQL ejecuta:

   REPAIR TABLE `nombre_de_tabla`;
   

   O mejor, marca todas las tablas y elige Reparar tabla en el menú desplegable.
2. Verifica la colación: todas las tablas deben tener la misma colación (normalmente utf8mb4_general_ci o utf8_general_ci). Si hay mezcla, desde phpMyAdmin ve a Operaciones y cambia la colación de toda la base de datos.
3. Aumenta el límite de tiempo de ejecución: en el archivo config/defines.inc.php, agrega o modifica:

   define('_PS_EXECUTION_TIME_', 300); // 5 minutos
   

   También puedes aumentar max_execution_time en PHP Settings de Plesk a 300.
4. Ejecuta la actualización manualmente: si el asistente falla, descarga el parche de actualización desde PrestaShop Downloads, súbelo por FTP a la carpeta admin/autoupgrade y ejecuta el script desde tu-tienda.com/admin/autoupgrade. Esto suele resolver problemas de conexión.

[TIP] Si la base de datos es muy grande, considera hacer la actualización por partes: primero sube los archivos nuevos, luego ejecuta el script de actualización de la BD desde la línea de comandos (si tienes SSH) con php upgrade.php.

Error 4: “El módulo no es compatible” o errores de módulos después de la actualización

Muchos errores actualización PrestaShop se deben a módulos de terceros que no están preparados para la nueva versión. Pueden causar desde fallos de funcionalidad hasta pantallas en blanco.

Solución

1. Identifica el módulo problemático: revisa el log de errores (como en el error 1) o desactiva todos los módulos y actívalos uno por uno desde Módulos > Administrador de módulos.
2. Actualiza los módulos: desde el back office, ve a Módulos > Catálogo de módulos y busca actualizaciones. Si no hay, contacta al desarrollador.
3. Reemplaza módulos incompatibles: si un módulo no se actualiza, busca una alternativa en el marketplace de PrestaShop o en foros.
4. Limpia la caché de módulos: elimina la carpeta cache/smarty/cache y cache/smarty/compile (puedes hacerlo desde el administrador de archivos de Plesk). Luego, desde el back office, ve a Parámetros avanzados > Rendimiento y haz clic en Limpiar caché.
5. Verifica la compatibilidad del tema: si usas un tema personalizado, asegúrate de que sea compatible con la nueva versión. Prueba cambiando temporalmente al tema predeterminado (por ejemplo, classic) para descartar problemas.

[WARNING] No actualices PrestaShop a la última versión si tienes muchos módulos de pago sin soporte. A veces es mejor esperar a que los desarrolladores lancen versiones compatibles.

Error 5: “El instalador no puede continuar” o error de versión de PHP

PrestaShop 8.x requiere PHP 7.4 o superior, pero si tu servidor usa una versión anterior, el instalador se detendrá.

Solución

1. Cambia la versión de PHP en Plesk: ve a Hosting & DNS > PHP Settings y selecciona PHP 7.4 o 8.0. Si no ves esa opción, contacta con tu proveedor de hosting para que la habilite.
2. Verifica las extensiones: en la misma sección, asegúrate de que las extensiones necesarias estén activadas (como curl, gd, json, mbstring, openssl, pdo_mysql, zip). Puedes activarlas desde Extensiones PHP.
3. Si usas Syspanel (puerto 2106): en la configuración del dominio, busca la opción de Versión de PHP y elige la más reciente compatible. Luego, desde el administrador de archivos, verifica que el archivo .htaccess no tenga directivas obsoletas.

[INFO] Si tu hosting no soporta PHP 7.4+, considera migrar a un plan que sí lo haga. Muchos proveedores low-cost ofrecen solo PHP 7.2 o inferior.

FAQ: Preguntas frecuentes sobre actualizar PrestaShop en Plesk

¿Qué hago si la tienda queda en blanco después de la actualización?

Sigue los pasos del Error 1: habilita el modo desarrollo, revisa los logs, desactiva módulos y aumenta la memoria PHP. Si no funciona, restaura la copia de seguridad.

¿Puedo saltar versiones al actualizar? (por ejemplo, de 1.6 a 8.0)

No recomendado. Lo ideal es actualizar paso a paso (1.6 → 1.7 → 8.0). Si intentas saltar, es muy probable que tengas errores actualización PrestaShop graves. Usa el asistente de actualización (1-Click Upgrade) que sugiere la versión intermedia.

¿Cómo sé si mi hosting es compatible con PrestaShop 8?

Revisa los requisitos en la documentación oficial: PHP 7.4+, MySQL 5.6+, extensiones específicas. Desde Plesk, puedes ver la versión de PHP y las extensiones en PHP Settings. También puedes ejecutar el script check.php que viene en el paquete de PrestaShop.

¿Qué pasa si el asistente de actualización se queda colgado?

Detén el proceso, limpia la caché y vuelve a intentarlo. Si sigue colgado, aumenta el tiempo de ejecución (como en el Error 3) o ejecuta la actualización manualmente subiendo los archivos y luego corriendo el script SQL.

¿Debo actualizar desde el back office o manualmente?

El asistente del back office (1-Click Upgrade) es más fácil, pero a veces falla. La actualización manual (subir archivos por FTP y luego ejecutar el script) es más segura si tienes experiencia. Para usuarios sin conocimientos técnicos, recomiendo el asistente.

Resumen final

Actualizar PrestaShop en Plesk no tiene por qué ser un dolor de cabeza. La clave está en la preparación: copia de seguridad, permisos correctos, versión de PHP adecuada y módulos compatibles. Si te encuentras con errores actualización PrestaShop, sigue los pasos de esta guía y, si todo falla, restaura la copia de seguridad y busca ayuda en foros especializados o con tu proveedor de hosting.

Recuerda que si usas Syspanel (puerto 2106), los principios son los mismos: verifica permisos, PHP y base de datos. Y no olvides que siempre es mejor prevenir que curar: mantén tu tienda actualizada periódicamente, pero siempre con cuidado.

[TIP] Si no te sientes seguro, contrata a un profesional. Una mala actualización puede dejar tu tienda offline por horas, lo que afecta tus ventas y SEO.