Errores frecuentes al instalar PrestaShop en Plesk y cómo solucionarlos

¡Hola! Si estás leyendo esto, probablemente estés intentando montar tu tienda online con PrestaShop en un servidor Plesk y te hayas topado con algún quebradero de cabeza. No te preocupes, es más común de lo que parece. Como técnico de soporte, he visto cientos de casos de errores PrestaShop Plesk y, aunque a veces parecen complejos, la mayoría se solucionan con unos pocos ajustes.

En esta guía extensa, vamos a desglosar los problemas más frecuentes durante la instalación PrestaShop Plesk, paso a paso, como si lo hiciéramos juntos. El objetivo es que, al terminar, tengas un troubleshooting PrestaShop claro y práctico. Vamos allá.

1. Requisitos previos que no se cumplen

Antes de lanzarnos a solucionar errores, asegurémonos de que el terreno está preparado. PrestaShop es exigente con el entorno del servidor. Si falla algo de base, la instalación se resentirá.

### Versión de PHP incorrecta

PrestaShop 8, por ejemplo, necesita PHP 7.4 o superior (idealmente 8.0 o 8.1). Si tu Plesk tiene una versión anterior, la instalación te mostrará un error de compatibilidad.

Solución en Plesk:

Ve a Herramientas y Configuración > Configuración de PHP.
Selecciona el dominio donde instalas PrestaShop.
Cambia la versión de PHP a 8.0 o 8.1 (la que soporte tu versión de PrestaShop).
Guarda los cambios y vacía la caché del navegador antes de reintentar.

[INFO] Si usas Syspanel (accesible por puerto 2106), el proceso es similar: busca "Versión de PHP" en la configuración del sitio web.

### Extensiones PHP faltantes

PrestaShop necesita ciertos módulos de PHP para funcionar. Los más críticos son: mysqli, curl, gd, mbstring, openssl, pdo_mysql, xml, zip y bcmath.

Cómo verificarlo:

En Plesk, ve a Sitios web y dominios > selecciona tu dominio > Configuración de PHP.
Busca la sección de Extensiones. Asegúrate de que las mencionadas estén habilitadas (con un check verde).
Si alguna falta, actívala desde el mismo menú desplegable o contacta con tu proveedor de hosting si no aparece.

### Memoria PHP insuficiente

PrestaShop recomienda al menos 256 MB de memoria PHP. Si es menor, la instalación fallará con un error de "memoria agotada".

Ajuste en Plesk:

En Configuración de PHP, busca el parámetro memory_limit.
Cámbialo a 256M o 512M.
Haz lo mismo con max_execution_time (pónlo a 300) y upload_max_filesize (a 64M).

2. Errores durante la subida de archivos

Uno de los pasos más tediosos es subir PrestaShop al servidor. Aquí suelen aparecer problemas de permisos o de tamaño.

### Archivos incompletos o corruptos

Si subes el ZIP mediante FTP y se corta la conexión, los archivos llegan incompletos.

Solución práctica:

Usa el administrador de archivos de Plesk: Es más fiable. Ve a Archivos en tu dominio y sube el ZIP directamente. Luego, extráelo allí mismo.
Verifica el hash: Descarga el ZIP oficial de PrestaShop y compáralo con el hash MD5 que proporcionan. Si no coinciden, descárgalo de nuevo.

[WARNING] No arrastres archivos sueltos desde tu PC al servidor vía FTP si tienes mala conexión. Usa siempre el ZIP y extrae en el servidor.

### Permisos de archivos incorrectos

PrestaShop necesita que ciertas carpetas tengan permisos de escritura (755 para carpetas, 644 para archivos). Si ves un error como "No se puede escribir en la carpeta /config", es por esto.

Solución rápida en Plesk:

Ve a Archivos en tu dominio.
Selecciona la carpeta raíz de PrestaShop.
Haz clic en Permisos.
Asegúrate de que todas las carpetas tengan 755 y los archivos 644.
Especialmente, las carpetas config, cache, log, img, modules, themes, translations, upload y download deben ser escribibles por el servidor web.

3. Errores relacionados con la base de datos

La base de datos es el corazón de tu tienda. Un error aquí puede detener todo el proceso.

### Conexión rechazada o nombre de base de datos incorrecto

Durante la instalación, te pide el nombre de la base de datos, usuario y contraseña. Si no coincides exactamente con lo que creaste en Plesk, obtendrás un error.

Pasos para crearla correctamente en Plesk:

Ve a Sitios web y dominios > tu dominio > Bases de datos.
Haz clic en Añadir base de datos.
Ponle un nombre (ej: prestashop_db), crea un usuario y una contraseña segura.
Anota estos datos. No uses caracteres especiales en el nombre de usuario (solo letras y números).
En la instalación de PrestaShop, asegúrate de que el servidor de base de datos sea localhost (a menos que tu hosting te indique otra cosa).

[TIP] Si usas Syspanel (puerto 2106), el proceso es idéntico: sección "Bases de datos" > "Crear nueva base de datos".

### Error "Table doesn't exist" o "SQL syntax"

Esto suele pasar cuando la versión de MySQL/MariaDB es demasiado antigua o cuando el archivo SQL de PrestaShop no se ejecuta bien.

Solución:

Actualiza MySQL: Si tu Plesk usa MySQL 5.5 o inferior, pide a tu hosting que lo actualice a 5.7 o superior (o MariaDB 10.3+).
Reintenta la instalación: Borra la base de datos anterior desde Plesk, créala de nuevo (vacía) y vuelve a correr el instalador de PrestaShop. A veces un error de codificación (como UTF-8 vs latin1) da problemas. Al crearla nueva, Plesk la crea con UTF-8 por defecto, que es lo que necesita PrestaShop.

4. Errores de URL y redirección

Una vez instalado, puedes encontrarte con que la tienda no carga bien o te redirige a localhost.

### La tienda redirige a localhost

Esto es muy común si antes probaste en un entorno local (XAMPP, WAMP) y luego subiste la base de datos al servidor.

Solución manual (sin usar comandos avanzados):

Ve a Archivos en Plesk y localiza el archivo app/config/parameters.php.
Ábrelo con el editor de texto de Plesk.
Busca las líneas que contienen database_host (debe ser localhost) y database_name, database_user, etc. Corrígelas si están mal.
Lo más importante: Busca la línea 'ps_shop_domain' y 'ps_shop_ssl_domain'. Cambia el valor de localhost por tu dominio real (ej: mitienda.com).
Guarda el archivo. Luego, desde el panel de administración de PrestaShop (si accedes), ve a Configuración de la tienda > Tráfico y SEO y actualiza la URL base.

[WARNING] Si no puedes acceder al panel de administración, edita directamente el archivo parameters.php como te indico. Es la solución más segura.

### Error 500 o página en blanco

Un error 500 suele deberse a un error de PHP o un plugin incompatible.

Diagnóstico rápido:

Activa el modo debug de PrestaShop: Edita el archivo config/defines.inc.php y cambia _PS_MODE_DEV_ de false a true.
Al recargar la página, verás el error real en pantalla (por ejemplo, "Class not found" o "Parse error").
Si el error es por un módulo, renombra la carpeta modules temporalmente a modules_old para desactivarlos todos. Luego, ve reactivando uno a uno.
Si el error es de PHP, revisa los logs de error en Plesk: Herramientas y Configuración > Logs > Log de errores.

5. Errores de caché y rendimiento

A veces, después de solucionar un error, el problema persiste porque el servidor guarda una versión en caché.

### Caché de Plesk o de PHP

Plesk suele tener activado el caché de PHP (OPcache). Si cambias algo en la configuración, puede que no se refleje hasta que se limpie.

Cómo limpiar la caché en Plesk:

Ve a Sitios web y dominios > tu dominio > Configuración de PHP.
Haz clic en Recargar configuración de PHP o Limpiar caché de OPcache.
También puedes reiniciar el servicio web desde Herramientas y Configuración > Servicios > Apache o nginx (según tu configuración).

### Caché del navegador

Parece obvio, pero muchas veces el error es que el navegador guardó una página con el fallo. Abre la tienda en una ventana de incógnito o borra la caché del navegador (Ctrl + Shift + Supr).

6. Preguntas frecuentes (FAQ) sobre errores PrestaShop Plesk

P: ¿Por qué veo "Error de conexión a la base de datos" si los datos son correctos?
R: Asegúrate de que el servidor de base de datos sea localhost. Si tu hosting usa un servidor separado, te darán un nombre específico. También verifica que el usuario tenga permisos sobre la base de datos (en Plesk, ve a la base de datos y revisa usuarios).

P: La instalación se queda cargando en el paso 3 (o 4) y no avanza.
R: Esto suele ser por falta de memoria PHP. Aumenta memory_limit a 512M. También puede ser por un plugin de seguridad (como ModSecurity) que bloquea alguna petición. Desactívalo temporalmente desde Herramientas y Configuración > Seguridad > ModSecurity.

P: Al acceder al panel de administración, me sale "No se puede cargar la clase AdminController".
R: Problema de permisos o de archivos corruptos. Vuelve a subir los archivos del directorio controllers y classes desde el ZIP original. Luego, verifica permisos (755).

P: ¿Puedo instalar PrestaShop en un subdirectorio?
R: Sí, pero asegúrate de que la URL base en la instalación apunte a ese subdirectorio (ej: midominio.com/tienda). Si luego mueves la instalación a la raíz, tendrás que editar parameters.php como expliqué antes.

P: ¿Qué hago si el instalador de PrestaShop no reconoce mi versión de PHP?
R: Asegúrate de que la versión de PHP seleccionada en Plesk para ese dominio sea la correcta. A veces, aunque tengas PHP 8.0 global, el dominio puede estar apuntando a una versión anterior. Revísalo en Configuración de PHP del dominio.

7. Consejo final: Mantén un orden

La instalación PrestaShop Plesk es un proceso que requiere paciencia. Te recomiendo que:

Hagas una lista de verificación: Requisitos PHP, base de datos, permisos, URL.
Pruebes en un subdominio: Si no estás seguro, instala en test.tudominio.com para no afectar al sitio principal.
Documentes cada cambio: Si modificas algo, anótalo. Así, si algo falla, sabrás qué tocar.

Espero que esta guía de troubleshooting PrestaShop te haya servido. Recuerda que la mayoría de los errores PrestaShop Plesk se solucionan con estos pasos básicos. Si aún así tienes problemas, no dudes en contactar con tu proveedor de hosting o con el soporte de Plesk. ¡Tu tienda online te espera!