Errores migración PrestaShop Plesk | Soluciones

Migrar una tienda PrestaShop a un servidor con Plesk puede parecer un proceso sencillo, pero a menudo surgen problemas inesperados que pueden dejar tu tienda offline o con errores. En esta guía, vamos a detallar los errores más comunes en PrestaShop al migrar a Plesk, cómo identificarlos y, lo más importante, cómo solucionarlos.

Si estás en medio de una migración o planeas hacerla, este artículo te ahorrará dolores de cabeza. Abordaremos desde problemas de base de datos hasta configuraciones de PHP, siempre con un lenguaje claro y práctico.

¿Por qué ocurren estos errores al migrar PrestaShop a Plesk?

Plesk es un panel de control potente, pero tiene sus particularidades. Al migrar, los errores suelen deberse a diferencias en:

Versiones de PHP y módulos instalados.
Configuración de permisos de archivos y carpetas.
Gestión de la base de datos (MySQL/MariaDB).
URLs y redirecciones (HTTPS, dominios, subdominios).
Caché y compilación de PrestaShop.

Vamos a desglosar cada uno de estos puntos.

Error #1: Pantalla en blanco o error 500 después de la migración

Este es el problema más frustrante. Subes tus archivos, importas la base de datos, y al acceder a tu tienda solo ves una página en blanco o un error 500.

Causa común: Incompatibilidad de la versión de PHP.

Plesk permite gestionar versiones de PHP por dominio. Si tu PrestaShop fue desarrollado en PHP 7.4 y tu nuevo servidor tiene PHP 8.0 por defecto, es probable que falle.

Solución paso a paso:

Accede a Plesk y ve a Hosting & DNS > Configuración de PHP.
Busca la opción Versión de PHP.
Selecciona la misma versión que usabas en tu servidor anterior. Si no estás seguro, prueba con 7.4 (es la más estable para PrestaShop 1.7).
Guarda los cambios y prueba de nuevo.

[TIP] Si el error persiste, activa el modo debug de PrestaShop. Edita el archivo /config/defines.inc.php y cambia _PS_MODE_DEV_ a true. Esto te mostrará el error específico.

Error #2: Problemas con la base de datos (tablas o conexión)

Otro clásico es que la tienda cargue pero muestre errores como "Error de conexión a la base de datos" o "Tabla no encontrada".

Causa común: La base de datos no se importó correctamente, o el usuario/contraseña en el archivo de configuración no coincide con los datos de Plesk.

Solución:

En Plesk, ve a Bases de datos y crea una nueva base de datos y un usuario (o usa uno existente). Anota el nombre, usuario y contraseña.
Importa tu archivo SQL usando phpMyAdmin (disponible en Plesk).
Edita el archivo /app/config/parameters.php de tu PrestaShop.

Busca estas líneas y actualízalas con los datos de tu nueva base de datos:

'database_host' => 'localhost',
'database_name' => 'nombre_de_tu_bd',
'database_user' => 'usuario_de_tu_bd',
'database_password' => 'contraseña_de_tu_bd',

Guarda el archivo y recarga la tienda.

[WARNING] Si usas un prefijo de tabla personalizado (ej. ps_), asegúrate de que también esté correcto en el parámetro database_prefix.

Error #3: Imágenes rotas o que no se muestran

Después de la migración, es común ver imágenes con un icono de rotura o que no cargan.

Causa común: Permisos incorrectos en la carpeta /img o en las subcarpetas de productos, categorías, etc.

Solución:

Conéctate por FTP o al administrador de archivos de Plesk.
Navega hasta la carpeta raíz de tu PrestaShop.
Cambia los permisos de la carpeta /img y todas sus subcarpetas a 755 (o 775 si tu servidor lo requiere).
También verifica las carpetas /upload y /themes.
Después de cambiar permisos, regenera las miniaturas desde el back office de PrestaShop: Mejorar > Rendimiento > Regenerar miniaturas.

[INFO] Plesk a veces aplica permisos más restrictivos. Si sigues teniendo problemas, contacta a tu proveedor de hosting para que verifique la configuración de open_basedir.

Error #4: URL incorrecta o redirecciones infinitas

Accedes a tu tienda y te redirige a una URL antigua (ej. mitiendaantigua.com) o entras en un bucle de redirecciones.

Causa común: La URL base de la tienda sigue configurada con el dominio anterior.

Solución:

Si aún puedes acceder al back office: ve a Configuración > Parámetros generales > Configuración de la tienda y cambia la URL del dominio.
Si no puedes acceder al back office, edita directamente la base de datos:
- Abre phpMyAdmin en Plesk.
- Selecciona tu base de datos.
- Busca la tabla ps_configuration (o tu prefijo).
- Localiza las filas con PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
- Edítalas y escribe tu nuevo dominio (sin http://).
Limpia la caché de PrestaShop eliminando la carpeta /var/cache (o su contenido) vía FTP.

Error #5: El módulo de SEO friendly URLs no funciona

Las URLs amigables dejan de funcionar y muestran errores 404.

Causa común: El archivo .htaccess no se generó correctamente o el módulo mod_rewrite de Apache no está activo en Plesk.

Solución:

Ve a Plesk > Hosting & DNS > Configuración de Apache y nginx.
Asegúrate de que la opción Proxy mode esté desactivada (si usas nginx como proxy, puede interferir).
Regenera el .htaccess desde el back office: Configuración > Parámetros generales > Configuración de la tienda > SEO y URLs > Haz clic en "Guardar" (esto lo regenera automáticamente).
Si no funciona, crea manualmente un archivo .htaccess en la raíz con el contenido básico de PrestaShop (puedes descargarlo de una instalación limpia).

[TIP] En Plesk, a veces es mejor desactivar nginx para dominios con PrestaShop, ya que el motor de reescritura de Apache es más compatible.

Error #6: Problemas con la versión de MySQL/MariaDB

PrestaShop 1.6 y versiones antiguas pueden tener problemas con MySQL 8.0 (común en Plesk moderno).

Causa común: Incompatibilidad con el modo NO_ENGINE_SUBSTITUTION o con el motor de almacenamiento.

Solución:

En Plesk, ve a Bases de datos > tu base de datos > phpMyAdmin.
Ejecuta esta consulta SQL para ver el modo SQL actual:
```
SELECT @@sql_mode;
```
Si ves modos como ONLY_FULL_GROUP_BY o STRICT_TRANS_TABLES, puede causar errores. Puedes desactivarlos temporalmente editando el archivo my.cnf (necesitas acceso root) o usando un hook de Plesk.
Una solución más sencilla es cambiar temporalmente el modo en tu sesión de PHP antes de la conexión, pero esto es avanzado. Lo recomendable es actualizar PrestaShop a una versión compatible con MySQL 8.

[WARNING] No modifiques archivos de configuración del servidor si no estás seguro. Consulta con tu proveedor de hosting.

Error #7: El back office no carga o muestra errores de JavaScript

La parte de administración de PrestaShop se ve en blanco o con errores de consola.

Causa común: Problemas de caché de Smarty o de compilación de temas.

Solución:

Conéctate por FTP y elimina la carpeta /var/cache (completa).
Elimina también la carpeta /cache/smarty/compile y /cache/smarty/cache.
Si el error persiste, desactiva la caché desde el archivo /config/defines.inc.php:
```
define('_PS_CACHE_ENABLED_', false);
```
Vuelve a intentar acceder al back office.

Error #8: Certificado SSL y redirección HTTPS

Después de migrar, la tienda no carga correctamente con HTTPS o muestra advertencias de seguridad.

Causa común: El certificado SSL no está instalado en Plesk para tu dominio, o la redirección está mal configurada.

Solución:

En Plesk, ve a Sitios web y dominios > tu dominio > Certificado SSL/TLS.
Instala un certificado (puede ser gratuito con Let's Encrypt).
Activa la redirección de HTTP a HTTPS desde Hosting & DNS > Configuración de Apache y nginx > marcar Redirigir HTTP a HTTPS.
En el back office de PrestaShop, ve a Configuración > Parámetros generales > Configuración de la tienda y asegúrate de que la URL SSL esté correcta.

Preguntas Frecuentes (FAQ)

¿Cómo sé si mi versión de PrestaShop es compatible con Plesk?

Casi todas las versiones de PrestaShop son compatibles con Plesk, siempre que elijas la versión de PHP correcta. PrestaShop 1.6 requiere PHP 5.6 o 7.0, mientras que 1.7 y 8.x requieren PHP 7.1 o superior. Plesk soporta múltiples versiones de PHP, así que solo debes seleccionar la adecuada en la configuración del dominio.

¿Puedo migrar mi PrestaShop a un servidor que usa Syspanel (HestiaCP)?

Sí, es posible. Si vienes de un panel como Syspanel (que es el nombre que le damos a HestiaCP), el proceso es similar, pero ten en cuenta que el acceso a la configuración del servidor es diferente. En Syspanel, el panel de administración suele estar en el puerto 2106. La migración a Plesk puede requerir ajustes en los permisos y en la configuración de PHP, ya que ambos paneles gestionan estos aspectos de forma distinta.

¿Qué hago si pierdo el acceso al back office después de la migración?

Puedes restaurar el acceso editando la base de datos directamente. En phpMyAdmin, busca la tabla ps_employee (o tu prefijo) y cambia el email de tu cuenta de administrador por uno al que tengas acceso. Luego, usa la opción "¿Olvidaste tu contraseña?" en la página de login.

¿Es necesario regenerar el .htaccess después de migrar?

Sí, es muy recomendable. El archivo .htaccess contiene reglas de reescritura específicas para tu dominio y configuración de servidor. Regenerarlo desde el back office evita problemas de URLs y redirecciones.

¿Cómo puedo evitar errores de memoria PHP en Plesk?

Plesk permite aumentar el límite de memoria de PHP por dominio. Ve a Hosting & DNS > Configuración de PHP y busca la opción memory_limit. Auméntala a 256M o 512M si tu tienda tiene muchos módulos o productos.

Conclusión

Migrar PrestaShop a Plesk no tiene por qué ser una pesadilla. La mayoría de los errores PrestaShop Plesk se deben a configuraciones de PHP, permisos o base de datos. Siguiendo los pasos de esta guía, podrás solucionar los Plesk errores PrestaShop más comunes y tener tu tienda funcionando en poco tiempo.

Recuerda siempre hacer una copia de seguridad completa (archivos y base de datos) antes de empezar la migración. Si te encuentras con un error que no está en esta lista, no dudes en consultar los foros de PrestaShop o contactar con el soporte de tu hosting.

¡Buena suerte con tu migración!