Errores comunes en PrestaShop en Plesk y cómo solucionarlos

Mudar tu tienda PrestaShop a un nuevo panel de control como Plesk puede ser un paso emocionante, pero a veces surgen pequeños contratiempos técnicos. No te preocupes, es completamente normal. Cuando hablamos de errores PrestaShop Plesk, la mayoría tienen solución en pocos minutos.

Este artículo está diseñado para guiarte paso a paso en la solución problemas PrestaShop después de migrar PrestaShop Plesk. Vamos a desglosar los fallos más habituales, desde el temido "error 500" hasta problemas con las imágenes o la conexión a la base de datos. Todo explicado de forma sencilla, sin tecnicismos complicados.

1. Error 500 (Internal Server Error) al cargar la tienda

Este es, sin duda, el error más común al migrar PrestaShop Plesk. El famoso "pantallazo blanco" o "Error 500" puede deberse a varias causas. Vamos a revisar las más frecuentes.

1.1. Permisos de archivos incorrectos

Plesk es muy estricto con los permisos de archivos. Después de la migración, los permisos suelen quedar mal configurados.

Solución:

Accede a tu panel de Plesk y ve a "Administrador de archivos" (File Manager).
Navega hasta la carpeta raíz de tu PrestaShop (normalmente httpdocs o public_html).
Selecciona TODOS los archivos y carpetas (Ctrl+A).
Haz clic en "Cambiar permisos".
Establece los siguientes valores:
- Carpetas: 755
- Archivos: 644
Aplica los cambios.

[TIP] Si no ves la opción de permisos por separado, puedes usar la casilla "Aplicar a subdirectorios" para que se actualice todo automáticamente.

1.2. Archivo .htaccess corrupto o incompatible

El .htaccess de tu antigua instalación puede no ser compatible con la configuración de Plesk.

Solución:

Ve al "Administrador de archivos".
Busca el archivo llamado .htaccess (puede estar oculto, activa la opción "Mostrar archivos ocultos").
Renómbralo a .htaccess_old (por si acaso).
Ahora, accede a tu tienda desde el navegador. PrestaShop regenerará automáticamente un nuevo .htaccess limpio.
Si no se regenera, ve a tu Back Office de PrestaShop > Parámetros de la tienda > Tráfico y SEO > URL amigables. Desactiva y vuelve a activar "URLs amigables" y guarda.

1.3. Versión de PHP incorrecta

PrestaShop necesita una versión de PHP específica. Si en Plesk tienes una versión demasiado nueva o demasiado antigua, fallará.

Solución:

En Plesk, ve a "Hosting y DNS" > "Configuración de hosting".
Busca la sección "PHP".
Selecciona una versión compatible:
- PrestaShop 1.6: PHP 5.6 o 7.0.
- PrestaShop 1.7: PHP 7.1, 7.2, 7.3 o 7.4.
- PrestaShop 8.x: PHP 8.0 o superior.
Guarda los cambios y recarga la tienda.

2. Error de conexión a la base de datos

Otro clásico. Aparece un mensaje como "Cannot connect to database" o "Error de conexión a la base de datos". Esto suele pasar porque los datos de conexión no están actualizados en el archivo de configuración de PrestaShop.

2.1. Revisar el archivo settings.inc.php

El archivo clave es app/config/parameters.php (en PrestaShop 1.7 y 8.x) o config/settings.inc.php (en PrestaShop 1.6).

Solución:

Desde el "Administrador de archivos", navega hasta la carpeta app/config/ o config/.
Abre el archivo parameters.php o settings.inc.php con el editor de texto.
Verifica que los datos de conexión coincidan con los de tu base de datos en Plesk:
- database_host: suele ser localhost (a veces cambia a una IP o nombre de servidor en Plesk).
- database_name: el nombre exacto de tu base de datos.
- database_user: el usuario de la base de datos.
- database_password: la contraseña correspondiente.

[WARNING] Si después de la migración cambiaste el usuario o la contraseña de la base de datos, debes actualizarlos aquí. Si no, PrestaShop no podrá conectarse.

2.2. Crear la base de datos desde cero (si la migración falló)

A veces la base de datos no se importa correctamente. Es mejor hacer una importación manual.

Solución:

En Plesk, ve a "Bases de datos" y crea una nueva base de datos y un usuario.
Usa la herramienta "phpMyAdmin" (disponible en Plesk) para importar tu archivo .sql de la base de datos original.
Actualiza los datos en parameters.php con los nuevos valores.

3. Problemas con imágenes rotas o que no cargan

Después de migrar PrestaShop Plesk, es habitual que las imágenes de productos no se vean. Aparecen como cuadrados rotos o simplemente no cargan.

3.1. Regenerar las imágenes desde el Back Office

La ruta de las imágenes puede haber cambiado. PrestaShop tiene una herramienta para regenerarlas.

Solución:

Accede a tu Back Office de PrestaShop.
Ve a "Diseño" > "Tema y logo" > "Avanzado".
Haz clic en "Regenerar imágenes".
Selecciona todas las opciones (productos, categorías, etc.) y desactiva "Borrar imágenes antiguas" (por si acaso).
Haz clic en "Regenerar". Espera unos minutos.

3.2. Verificar la carpeta "img"

A veces la carpeta img no se copió completamente durante la migración.

Solución:

Ve al "Administrador de archivos".
Revisa que la carpeta img exista y contenga subcarpetas como p, c, m, etc.
Si está vacía, tendrás que subir la carpeta img desde tu copia de seguridad original.

4. Problemas con los módulos (incompatibilidad o errores)

Los módulos de PrestaShop pueden dar errores si la versión de PHP o la configuración del servidor no es la adecuada.

4.1. Desactivar módulos problemáticos

Si ves un error en una página concreta (por ejemplo, el carrito o el checkout), puede ser un módulo.

Solución:

Ve a "Módulos" > "Gestor de módulos".
Busca módulos que tengan un icono de advertencia o que no estén actualizados.
Desactívalos temporalmente.
Si el error desaparece, ese módulo es el culpable. Actualízalo o busca una alternativa.

4.2. Forzar la compatibilidad de módulos

Algunos módulos no son compatibles con la versión de PHP de Plesk.

Solución:

En el Back Office, ve a "Módulos" > "Gestor de módulos".
Haz clic en "Ajustes avanzados" (o icono de engranaje).
Activa "Mostrar módulos no compatibles".
Si ves un módulo que necesitas, puedes intentar forzar su instalación, pero no es recomendable. Mejor busca una versión compatible.

5. Error de URL o redireccionamiento infinito

Después de la migración, la URL de tu tienda puede no coincidir con la nueva dirección en Plesk.

5.1. Cambiar la URL en la base de datos

Si la URL de tu tienda sigue apuntando al dominio antiguo, tendrás que actualizarla directamente en la base de datos.

Solución:

Accede a phpMyAdmin desde Plesk.
Selecciona tu base de datos de PrestaShop.
Busca la tabla ps_configuration (o ps_shop_url).
Localiza las filas con name = PS_SHOP_DOMAIN y PS_SHOP_DOMAIN_SSL.
Edítalas y cambia el valor por tu nuevo dominio (ej: mutiendanueva.com).
También en la tabla ps_shop_url, actualiza el campo domain y domain_ssl.

[INFO] Si no sabes usar phpMyAdmin, también puedes hacerlo desde el Back Office: Parámetros de la tienda > Configuración general > Configuración de la tienda. Pero a veces el Back Office no carga si la URL es incorrecta, por eso es mejor hacerlo en la base de datos.

6. Error de caché o archivos temporales

A veces, después de la migración, la caché de PrestaShop o de Plesk guarda datos antiguos que dan errores.

6.1. Limpiar la caché de PrestaShop

Solución:

Ve a "Parámetros avanzados" > "Rendimiento".
Haz clic en "Limpiar la caché" (tanto la de Smarty como la del servidor).
También puedes borrar manualmente la carpeta var/cache (en PrestaShop 1.7) o cache/smarty/cache y cache/smarty/compile (en PrestaShop 1.6) desde el Administrador de archivos.

6.2. Limpiar la caché de Plesk

Plesk tiene su propia caché que puede interferir.

Solución:

En Plesk, ve a "Herramientas y ajustes" > "Caché del panel".
Haz clic en "Limpiar toda la caché".
También puedes reiniciar el servicio "Apache" o "Nginx" desde "Servicios" en Plesk.

7. Preguntas Frecuentes (FAQ)

¿Por qué aparece "Error 503 Service Unavailable" al migrar?
Esto suele deberse a que el servidor está en modo mantenimiento o el archivo .htaccess tiene reglas incorrectas. Borra el .htaccess temporalmente y vuelve a generarlo desde el Back Office.

¿Qué hago si no puedo acceder al Back Office?
Si el Back Office no carga, prueba a acceder directamente: tudominio.com/adminXXXXX/index.php (donde adminXXXXX es tu carpeta de administración). Si sigue sin funcionar, revisa los permisos de la carpeta admin y el archivo .htaccess.

¿Cómo sé si mi base de datos se importó bien?
Revisa en phpMyAdmin que todas las tablas estén presentes (suelen ser más de 200). Si faltan, importa de nuevo el archivo .sql.

¿Puedo usar la misma base de datos para dos tiendas?
No, cada tienda necesita su propia base de datos. Si intentas usar la misma, dará errores de conexión.

[WARNING] Si después de seguir todos estos pasos el error persiste, revisa los logs de error de Plesk. Ve a "Hosting y DNS" > "Registros" y busca errores recientes. El código de error te dará pistas más precisas.

Conclusión

Migrar PrestaShop a Plesk es un proceso que, aunque puede tener sus pequeños sobresaltos, es totalmente manejable. La mayoría de los errores PrestaShop Plesk se solucionan ajustando permisos, actualizando la versión de PHP o corrigiendo los datos de conexión a la base de datos.

Recuerda siempre hacer una copia de seguridad completa antes de cualquier cambio. Y si te sientes perdido, no dudes en contactar con el soporte de tu hosting o con un desarrollador especializado. ¡Tu tienda online volverá a funcionar en poco tiempo!

Esperamos que esta guía te haya sido de gran ayuda para solucionar problemas PrestaShop después de tu migración.