Solución error conexión base de datos PrestaShop en Plesk | FAQ

¡Hola! Soy tu técnico de soporte amigable. Si estás viendo un molesto mensaje de error base de datos PrestaShop Plesk o una pantalla en blanco con un texto como “Cannot connect to database” o “Error de conexión a la base de datos”, no te preocupes. Es uno de los problemas más comunes en PrestaShop y, por suerte, casi siempre tiene solución.

En esta guía completa te voy a explicar paso a paso cómo diagnosticar y resolver el error de conexión base de datos PrestaShop Plesk que impide que tu tienda funcione. Veremos desde las causas más simples (como un cambio de contraseña) hasta las más complejas (como corrupción de archivos o problemas de permisos). Todo explicado de forma muy visual, con listas y pasos numerados, para que puedas seguirlo aunque no seas un experto técnico.

Vamos a ello.

¿Qué significa este error y por qué aparece?

El mensaje de conexión fallida PrestaShop indica que tu tienda no logra comunicarse con la base de datos donde se almacenan productos, pedidos, clientes y configuraciones. Sin esa conexión, PrestaShop no puede funcionar.

Las causas más habituales son:

Cambio de contraseña de la base de datos (el usuario o la contraseña ya no coinciden).
El servidor de base de datos (MySQL/MariaDB) está caído o sobrecargado.
Los datos de acceso en el archivo de configuración de PrestaShop son incorrectos.
El usuario de la base de datos ha perdido permisos.
Problemas con Plesk (por ejemplo, después de una migración o actualización).
Archivos del núcleo de PrestaShop corruptos o faltantes.
Firewall o bloqueo de puertos (aunque es menos común en entornos compartidos).

No te asustes. Vamos a solucionarlo paso a paso.

Paso 1: Verifica el estado del servicio de base de datos en Plesk

Lo primero es asegurarnos de que el motor de base de datos (MySQL o MariaDB) esté funcionando. Si está detenido, ningún sitio web podrá conectar.

Accede a Plesk con tu usuario administrador o el usuario de hosting.
En el panel izquierdo, busca la sección “Herramientas y ajustes” (o directamente “Servicios” si tienes una versión reciente).
Haz clic en “Gestión de servicios” o “Servicios del sistema”.
Busca en la lista “MySQL” o “MariaDB” (depende de lo que uses).
Verifica que su estado sea “En ejecución” (Running). Si está detenido, haz clic en “Iniciar”.

[TIP]: Si no ves el servicio, puede que tu plan de hosting no incluya acceso a estos ajustes. En ese caso, contacta con tu proveedor de hosting y pídeles que verifiquen que MySQL/MariaDB está activo.

Si el servicio estaba detenido y lo iniciaste, prueba a recargar tu tienda. Si el error persiste, continúa con el siguiente paso.

Paso 2: Revisa las credenciales en el archivo de configuración de PrestaShop

PrestaShop guarda los datos de conexión a la base de datos en un archivo llamado app/config/parameters.php (en versiones modernas) o config/settings.inc.php (en versiones antiguas). Aquí es donde suele estar el error si cambiaste la contraseña recientemente.

Localiza el archivo correcto

PrestaShop 1.7 y 8.x: [raíz de tu tienda]/app/config/parameters.php
PrestaShop 1.6 y anteriores: [raíz de tu tienda]/config/settings.inc.php

Edítalo con cuidado

Conéctate a tu hosting por FTP (FileZilla, Cyberduck, etc.) o usa el Administrador de archivos de Plesk (en la sección “Archivos” de tu dominio).
Navega hasta la carpeta donde está el archivo.
Descarga una copia de seguridad del archivo (por si acaso).
Ábrelo con un editor de texto plano (Bloc de notas, Sublime Text, etc.).
Busca las líneas que contienen:
- 'database_host' (normalmente 127.0.0.1 o localhost)
- 'database_name' (el nombre de tu base de datos)
- 'database_user' (el usuario)
- 'database_password' (la contraseña)
Comprueba que coincidan exactamente con los datos que tienes en Plesk.

Cómo obtener los datos correctos desde Plesk

En Plesk, ve a “Bases de datos” (dentro de tu dominio o suscripción).
Verás una lista de bases de datos. Haz clic en el nombre de la base de datos que usa tu PrestaShop.
Ahí verás el nombre de la base de datos, el usuario y la contraseña actual. Si no la recuerdas, puedes cambiarla desde el mismo panel (pero luego tendrás que actualizar el archivo de configuración).

[WARNING]: Si cambias la contraseña desde Plesk, deberás actualizar el archivo parameters.php o settings.inc.php con la nueva contraseña. De lo contrario, el error persistirá.

Si los datos no coinciden, corrígelos en el archivo de configuración y guarda los cambios.

Paso 3: Verifica los permisos del usuario de la base de datos

A veces el usuario tiene la contraseña correcta, pero ha perdido los permisos sobre la base de datos. Esto puede ocurrir tras una restauración o migración.

En Plesk, ve a “Bases de datos”.
Haz clic en el nombre de tu base de datos.
Busca la sección “Usuarios” o “Permisos”.
Asegúrate de que el usuario que utiliza PrestaShop tenga marcados todos los permisos (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Lo más seguro es marcar “Todos los privilegios”.
Si no está, edita el usuario y asígnale todos los permisos.

[INFO]: Si tienes varios usuarios, asegúrate de que el que está configurado en parameters.php es el mismo que tiene los permisos.

Paso 4: Comprueba el host de la base de datos (no siempre es “localhost”)

En entornos Plesk, a veces la base de datos no está en el mismo servidor que el sitio web (por ejemplo, en configuraciones con servidores separados). El valor de database_host puede ser una dirección IP o un nombre como mysql.example.com.

En Plesk, dentro de la base de datos, busca el campo “Servidor” o “Host”.
Copia ese valor exacto.
Pégalo en el archivo de configuración de PrestaShop en lugar de 127.0.0.1 o localhost.

Si no estás seguro, consulta con tu proveedor de hosting.

Paso 5: Revisa si hay conflictos con caché o archivos corruptos

A veces el error aparece porque PrestaShop tiene una caché obsoleta o algún archivo del núcleo está dañado.

Limpia la caché de PrestaShop (si puedes acceder al back office)

Si aún puedes acceder al panel de administración, ve a “Parámetros de la tienda” > “Rendimiento” y haz clic en “Limpiar caché”. Pero como lo más probable es que no puedas ni entrar, haremos esto manualmente.

Elimina manualmente los archivos de caché

Conéctate por FTP o al Administrador de archivos de Plesk.
Elimina todo el contenido de la carpeta /var/cache/ (en PrestaShop 1.7 y 8) o /cache/ (en versiones antiguas).
También puedes eliminar la carpeta /var/cache/prod/ (para la tienda en producción).

Regenera el archivo .htaccess (opcional pero recomendado)

Renombra el archivo .htaccess en la raíz de tu tienda a .htaccess_old.
Accede a tu tienda en el navegador. PrestaShop debería regenerar automáticamente un nuevo .htaccess. Si el error de base de datos persiste, no podrá hacerlo, pero no pasa nada: luego lo restauraremos.

Paso 6: Prueba la conexión desde la línea de comandos (si tienes acceso SSH)

Si tu hosting te permite acceso SSH, puedes verificar si la conexión directa funciona. Esto ayuda a descartar problemas de red o de PrestaShop.

Conéctate por SSH a tu servidor.
Ejecuta el siguiente comando (reemplaza usuario, contraseña, nombre_base y host con los datos reales):
```
mysql -u usuario -p -h host nombre_base
```
Te pedirá la contraseña. Escríbela y pulsa Enter.
Si ves el prompt mysql> significa que la conexión es correcta. Escribe EXIT; para salir.
Si recibes un error como “Access denied” o “Can’t connect”, el problema está en las credenciales o en los permisos del usuario (vuelve al paso 2 y 3).

[INFO]: Si no tienes SSH, puedes usar la herramienta “phpMyAdmin” desde Plesk. Ve a “Bases de datos”, haz clic en el nombre de tu base y luego en “phpMyAdmin”. Intenta iniciar sesión con el usuario y contraseña que tienes configurados. Si no puedes, las credenciales son incorrectas.

Paso 7: Restaura una copia de seguridad de la base de datos

Si después de todos los pasos anteriores el error persiste, es posible que la base de datos esté corrupta. En ese caso, la solución más rápida es restaurar una copia de seguridad reciente.

En Plesk, ve a “Bases de datos”.
Haz clic en el nombre de tu base de datos.
Busca la opción “Restaurar copia de seguridad” o “Importar”.
Selecciona un archivo de respaldo (.sql o .gz) que tengas guardado.
Confirma la restauración.

[WARNING]: Esto sobrescribirá todos los datos actuales. Si no tienes una copia de seguridad, contacta con tu proveedor de hosting para ver si ellos tienen una.

Paso 8: Soluciones avanzadas (para cuando nada de lo anterior funciona)

Si el error sigue apareciendo, podemos probar algunas soluciones más técnicas:

8.1. Verifica los logs de errores de PrestaShop

PrestaShop guarda logs en la carpeta /var/logs/ (en versiones modernas). Busca archivos con extensión .log y ábrelos. Pueden darte pistas más concretas sobre el error.

8.2. Comprueba la versión de PHP

PrestaShop requiere una versión específica de PHP. Si actualizaste PHP recientemente, puede haber incompatibilidad. En Plesk, ve a “Configuración de PHP” de tu dominio y asegúrate de que la versión sea compatible con tu PrestaShop (por ejemplo, 7.4, 8.0 u 8.1).

8.3. Desactiva módulos conflictivos (si puedes acceder al back office)

Si logras entrar al back office (aunque sea con lentitud), desactiva módulos de terceros uno por uno para identificar si alguno está causando el error de conexión.

8.4. Repara archivos del núcleo de PrestaShop

Descarga la misma versión de PrestaShop que tienes instalada desde el sitio oficial. Sube por FTP solo los archivos de la carpeta /classes/, /controllers/ y /src/ (sobrescribiendo los existentes). Esto repara posibles corrupciones.

Preguntas frecuentes (FAQ)

¿Puedo solucionar el error sin acceso al panel de administración de PrestaShop?

Sí, todo lo que hemos explicado se puede hacer desde Plesk o FTP. No necesitas entrar al back office.

¿Por qué aparece el error después de mover mi tienda a otro servidor?

Porque los datos de conexión (host, usuario, contraseña) cambian. Debes actualizar el archivo parameters.php con los nuevos valores.

¿Qué hago si no encuentro el archivo parameters.php?

En PrestaShop 1.6 y anteriores se llama settings.inc.php y está en la carpeta /config/. En versiones modernas, está en /app/config/parameters.php. Si no existe, puede que tu instalación esté corrupta; prueba a subir el archivo desde una copia limpia de PrestaShop.

¿El error puede deberse a un plugin de seguridad como un firewall?

Sí, algunos firewalls (como ModSecurity) pueden bloquear las consultas a la base de datos. Prueba a desactivarlo temporalmente desde Plesk (en “Configuración de seguridad” o “Firewall”).

¿Debo contactar con soporte técnico?

Si después de seguir todos los pasos el error continúa, es hora de pedir ayuda a tu proveedor de hosting. Ellos pueden revisar logs del servidor y permisos a nivel de sistema que tú no puedes modificar.

Resumen final

El error base de datos PrestaShop Plesk es frustrante, pero en el 90% de los casos se soluciona corrigiendo las credenciales en el archivo de configuración o reiniciando el servicio MySQL. Recuerda:

Siempre haz una copia de seguridad antes de modificar archivos.
Verifica que el usuario de la base de datos tenga todos los permisos.
Si cambiaste la contraseña, actualiza el archivo parameters.php o settings.inc.php.
No olvides limpiar la caché después de hacer cambios.

Espero que esta guía te haya sido de gran ayuda. Si te quedas atascado en algún paso, no dudes en volver a leer la sección correspondiente o contactar con tu equipo de soporte. ¡Tu tienda volverá a funcionar en poco tiempo!

[TIP]: Para evitar futuros problemas, te recomiendo anotar en un lugar seguro las credenciales de tu base de datos y hacer copias de seguridad periódicas desde Plesk.

¡Mucho éxito con tu PrestaShop!