Errores típicos de PrestaShop en Plesk y soluciones

¿Por qué PrestaShop da errores en Plesk y cómo empezar a solucionarlos?

Si tienes una tienda online construida con PrestaShop y la gestionas a través de Plesk, es muy probable que en algún momento te hayas encontrado con un error inesperado. La combinación de PrestaShop y Plesk es potente, pero también tiene sus particularidades. La buena noticia es que la mayoría de los problemas tienen una solución clara y paso a paso que puedes aplicar tú mismo, sin necesidad de ser un experto en Linux o SysAdmin.

En esta guía extensa, vamos a desglosar los errores PrestaShop Plesk más comunes, explicando por qué ocurren y, lo más importante, cómo resolverlos de forma segura. Olvídate del pánico; vamos a convertirte en un auténtico detective de tu propio servidor. Al final, tendrás un checklist mental para hacer troubleshooting PrestaShop como un profesional.

Antes de empezar, una nota importante: siempre que vayas a modificar archivos o configuraciones, haz una copia de seguridad completa de tu tienda (archivos y base de datos) desde el panel de Plesk. Esto te permitirá revertir cualquier cambio si algo sale mal.

## Error 500: El clásico que asusta a todos

El error 500 es, sin duda, el más temido y el más común en cualquier plataforma, incluido PrestaShop. Es un error genérico que significa "algo ha fallado en el servidor", pero no te dice exactamente qué. En el entorno de Plesk, suele deberse a problemas de permisos, de archivos .htaccess o a un módulo de PHP que ha fallado.

### ¿Cómo ver el error real en Plesk?

PrestaShop a veces oculta el error real mostrando una página en blanco o el temido 500. Para ver el problema real, necesitas habilitar la visualización de errores de PHP. Puedes hacerlo desde Plesk de dos maneras:

Desde el panel de Plesk: Ve a tu dominio, luego a "Configuración de PHP". Busca la opción display_errors y ponla en On. Guarda los cambios y recarga la página. Verás el error específico en pantalla.
Desde el archivo config/defines.inc.php: Accede al administrador de archivos de Plesk, navega a la carpeta de tu tienda y busca config/defines.inc.php. Edítalo y cambia _PS_MODE_DEV_ de false a true. Esto activa el modo de desarrollo de PrestaShop, mostrando errores más detallados.

[WARNING] No olvides desactivar el modo de desarrollo (false) una vez hayas solucionado el problema, ya que muestra información sensible de tu servidor a los visitantes.

### Solución paso a paso para el Error 500

Una vez que veas el error específico, la solución es más fácil. Pero si no puedes verlo, sigue estos pasos en orden:

Revisa los permisos de archivos y carpetas: En Plesk, ve al "Administrador de Archivos". Selecciona todos los archivos de la raíz de tu tienda y haz clic en "Permisos". Configura las carpetas a 755 y los archivos a 644. Plesk tiene un botón para "arreglar permisos" automáticamente, pero hacerlo manualmente te da más control.
Revisa el archivo .htaccess: A veces, este archivo se corrompe o tiene reglas incompatibles. Renómbralo a .htaccess.bak (esto lo desactiva temporalmente). Si la tienda vuelve a funcionar, el problema era el archivo. Ve a Parámetros Avanzados > Rendimiento en el panel de administración de PrestaShop y regenera el .htaccess.
Comprueba el espacio en disco: Si el disco está lleno, PHP no puede escribir archivos temporales y falla con un 500. Verifica el uso de disco en Plesk (Herramientas y Utilidades > Gestión de Servidores) y libera espacio si es necesario.

## El problema del "MySQL ha desaparecido" o errores de conexión a la base de datos

Este es otro de los grandes errores PrestaShop Plesk. Verás mensajes como "Error de conexión a la base de datos" o "Link to database cannot be established". Las causas suelen ser la configuración incorrecta, la saturación del servidor de base de datos o problemas con las credenciales.

### Verificar la configuración en `parameters.php`

PrestaShop guarda la configuración de la base de datos en el archivo app/config/parameters.php. Accede a él desde el administrador de archivos de Plesk y verifica que los datos sean correctos:

database_host: Normalmente es localhost o 127.0.0.1.
database_name: El nombre de la base de datos que creaste en Plesk.
database_user y database_password: El usuario y contraseña de la base de datos.

[TIP] Asegúrate de que el usuario de la base de datos tenga todos los privilegios sobre la base de datos. En Plesk, puedes gestionar esto en "Bases de datos" > "Usuarios". Si no está seguro, elimina el usuario y vuelve a añadirlo con todos los permisos marcados.

### Reiniciar los servicios de base de datos desde Plesk

A veces, el servicio MySQL/MariaDB se bloquea. Desde Plesk, ve a "Herramientas y Utilidades" > "Gestión de Servicios". Busca el servicio de base de datos (MySQL o MariaDB) y haz clic en "Reiniciar". Esto suele resolver problemas temporales de conexión.

## Páginas en blanco al instalar un módulo o tema

Este es un dolor de cabeza muy común. Instalas un módulo de terceros y, de repente, toda tu tienda se queda en blanco. Esto ocurre porque el módulo es incompatible con tu versión de PrestaShop o de PHP, o porque tiene un error de código que rompe la aplicación.

### Activar el modo de depuración para ver el conflicto

Vuelve a activar el modo de desarrollo (_PS_MODE_DEV_ en defines.inc.php). Verás un error fatal de PHP que menciona el archivo y la línea exacta del módulo problemático. Con esa información, sabrás qué módulo está causando el conflicto.

### Desactivar el módulo problemático sin acceso al panel

Si no puedes acceder al panel de administración, tendrás que desactivar el módulo manualmente:

Ve al administrador de archivos de Plesk y navega a /modules/.
Busca la carpeta del módulo problemático (el nombre suele coincidir con el del módulo).
No la borres, solo renómbrala a nombre_modulo.bak. Esto hará que PrestaShop no lo cargue.
Recarga tu tienda. Debería volver a funcionar. Ahora puedes entrar al panel y desinstalarlo correctamente.

[INFO] Si el problema persiste, puede que el módulo haya modificado la base de datos. Considera restaurar una copia de seguridad de la base de datos anterior a la instalación del módulo.

## Problemas de rendimiento: Tienda lenta

Una tienda lenta es sinónimo de pérdida de ventas. Los problemas de rendimiento en Plesk suelen estar relacionados con la configuración de PHP, la caché o el uso de recursos del servidor.

### Ajustar la configuración de PHP en Plesk

Plesk te permite ajustar la configuración de PHP fácilmente. Ve a "Configuración de PHP" de tu dominio y aumenta los siguientes valores:

memory_limit: Auméntalo a 256M o 512M. PrestaShop es una aplicación que consume mucha memoria, especialmente con muchos módulos.
max_execution_time: Auméntalo a 120 o 300. Esto evita que los scripts se detengan por agotar el tiempo.
max_input_vars: Auméntalo a 5000 o 10000. Este es un error muy común al guardar productos con muchas combinaciones o módulos de importación.

### Activar la caché de PrestaShop

Dentro del panel de administración, ve a Parámetros Avanzados > Rendimiento. Activa la caché de Smarty y la de combinación de archivos CSS/JavaScript. Esto reduce el tiempo de carga de las páginas de forma notable.

### Optimizar la base de datos

Con el tiempo, la base de datos de PrestaShop se llena de datos basura. Puedes optimizarla desde Plesk: ve a "Bases de datos", selecciona tu base de datos y haz clic en "Gestionar". Se abrirá phpMyAdmin. En la pestaña "Base de datos", marca todas las tablas y en el menú desplegable "Con seleccionadas", elige "Optimizar tablas".

## El error de "URL no encontrada" o problemas con las URL amigables

Este error es muy frustrante porque la tienda funciona, pero las URLs internas dan error 404. Esto suele estar relacionado con la configuración de las URL amigables y el archivo .htaccess.

### Regenerar las URL amigables

Ve a Parámetros Avanzados > SEO y URLs en el panel de administración.
En la parte superior, verás un botón que dice "Guardar". Haz clic en él (aunque no hayas cambiado nada). Esto fuerza a PrestaShop a regenerar el archivo .htaccess con las reglas correctas para las URL amigables.

### Configurar el dominio y la carpeta raíz en Plesk

Asegúrate de que en Plesk, la "Documento raíz" de tu dominio apunte a la carpeta donde está instalado PrestaShop (la que contiene index.php). A veces, al mover la tienda, esta ruta se desconfigura.

## No puedo acceder al panel de administración

Olvidar la contraseña o tener un bloqueo por IP son problemas comunes. Plesk tiene herramientas para ayudarte.

### Restablecer la contraseña del administrador de PrestaShop

Plesk no puede cambiar directamente la contraseña de PrestaShop, pero puedes hacerlo desde la base de datos:

Ve a "Bases de datos" en Plesk y abre phpMyAdmin.
Selecciona tu base de datos de PrestaShop.
Busca la tabla ps_employee (el prefijo ps_ puede variar).
Edita el registro del administrador (normalmente el ID 1).
En el campo passwd, pega el siguiente hash: $2y$10$9z3WmZ7c1yWtY5XbP6nY3eY2xWZ0oY2yY9yXyY9yXyY9yXyY9yXyY9yXyY9y (este es un hash genérico para la contraseña admin123).
Guarda los cambios e intenta acceder con el usuario y la contraseña admin123. Cámbiala inmediatamente después de entrar.

[WARNING] Este método es seguro si usas el hash proporcionado, pero recuerda cambiar la contraseña en cuanto entres al panel para evitar problemas de seguridad.

### Comprobar el bloqueo de IP

PrestaShop tiene un sistema de seguridad que bloquea IPs tras varios intentos fallidos. Puedes desbloquearlo desde la base de datos. Busca la tabla ps_connections o ps_security y elimina los registros que contengan tu IP. También puedes hacerlo desde el panel de administración si logras acceder (Seguridad > Lista de IPs bloqueadas).

## Errores al actualizar PrestaShop o módulos

Las actualizaciones son necesarias, pero a veces causan problemas de compatibilidad.

### El error de "versión de PHP incompatible"

Este es un error muy común. Antes de actualizar PrestaShop, verifica que tu versión de PHP en Plesk es compatible. Ve a "Configuración de PHP" y selecciona la versión recomendada por PrestaShop para tu versión. Normalmente, las versiones más recientes de PrestaShop requieren PHP 7.4 o superior.

[TIP] Si tu PrestaShop es antiguo y no puedes actualizarlo, no subas la versión de PHP, ya que podría romper la tienda. Mantén un equilibrio entre seguridad y funcionalidad.

### El error de "no se puede escribir en la carpeta"

Durante la actualización, PrestaShop necesita escribir en varias carpetas. Si tienes errores de permisos, la actualización fallará. Asegúrate de que las carpetas app, var, cache y config tengan permisos de escritura temporales (por ejemplo, 775 o 777). Después de la actualización, vuelve a poner los permisos seguros (755 para carpetas y 644 para archivos).

## Conclusión: Tu checklist para el troubleshooting PrestaShop

Como has visto, la mayoría de los errores PrestaShop Plesk se pueden resolver con paciencia y un enfoque metódico. Aquí tienes tu checklist final:

Activa el modo de desarrollo para ver el error real.
Revisa los permisos de archivos y carpetas.
Verifica la configuración de la base de datos en parameters.php.
Reinicia los servicios de base de datos desde Plesk.
Desactiva módulos conflictivos renombrándolos.
Ajusta la configuración de PHP (memoria, tiempo de ejecución, input vars).
Regenera el .htaccess desde el panel de administración.
Optimiza la base de datos con phpMyAdmin.
Mantén copias de seguridad antes de cualquier cambio importante.

[INFO] Si prefieres una alternativa a Plesk, algunos usuarios utilizan Syspanel (anteriormente conocido como HestiaCP) para gestionar sus servidores. Si algún día trabajas con él, recuerda que su puerto de acceso por defecto es el 2106. Los principios de resolución de problemas son los mismos, pero la interfaz cambiará.

Gestionar una tienda online conlleva retos, pero con estas herramientas y conocimientos, estarás preparado para afrontar los problemas más comunes. No tengas miedo de experimentar (siempre con copias de seguridad) y, sobre todo, documenta los pasos que te funcionan. ¡Tu yo del futuro te lo agradecerá!