Error de conexión a BD en PrestaShop con Plesk: Solución

¡Hola! Si has llegado hasta aquí, probablemente te has encontrado con un mensaje de error de conexión a la base de datos en tu tienda PrestaShop alojada en un servidor con Plesk. No te preocupes, es uno de los problemas más comunes y, en la gran mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

En esta guía completa y paso a paso, vamos a desglosar todas las causas posibles y, lo más importante, cómo solucionarlas. Vamos a ello.

¿Qué significa exactamente el error de conexión a la base de datos?

Cuando PrestaShop no puede conectarse a MySQL o MariaDB (el motor de base de datos), te mostrará un mensaje como "Error de conexión a la base de datos" o "Link to database cannot be established". Esto significa que tu tienda no puede leer ni escribir información, por lo que no puede mostrar productos, procesar carritos o acceder al panel de administración.

La buena noticia es que, salvo que el servidor esté caído, este error suele deberse a un cambio de contraseña, un archivo de configuración desactualizado o un problema de permisos. Vamos a diagnosticarlo y solucionarlo.

Causa #1: Credenciales incorrectas en el archivo de configuración (La más común)

La causa más frecuente de este error es que las credenciales de acceso (usuario, contraseña o nombre de la base de datos) guardadas en el archivo de configuración de PrestaShop no coinciden con las reales de tu servidor Plesk. Esto pasa mucho cuando se cambia la contraseña de la base de datos desde Plesk y no se actualiza el archivo de PrestaShop.

¿Cómo lo soluciono?

Necesitas editar el archivo parameters.php que se encuentra en la carpeta app/config/ de tu instalación de PrestaShop.

Accede a tu panel de Plesk y ve a "Administrador de archivos" (o usa un cliente FTP como FileZilla).
Navega hasta la raíz de tu tienda, normalmente httpdocs o public_html.
Entra en la carpeta app, luego en config y busca el archivo parameters.php.
Haz clic derecho sobre él y selecciona "Editar" (o descárgalo, edítalo con un editor de texto como el Bloc de notas y súbelo de nuevo).
Busca las líneas que dicen 'database_host', 'database_name', 'database_user' y 'database_password'.

[WARNING] Ten mucho cuidado al editar este archivo. Un error de sintaxis (una coma o comilla mal puesta) puede romper tu tienda por completo. Si usas el editor de Plesk, guarda una copia de seguridad antes de hacer cambios.

Compara los valores con los de tu base de datos real. Para obtener los datos correctos, ve a Plesk > Bases de datos. Ahí verás el nombre de la base de datos y el usuario. Para ver o cambiar la contraseña, haz clic en el usuario correspondiente.
Si los datos no coinciden, corrígelos y guarda el archivo.

[TIP] Si has cambiado la contraseña recientemente, este es el primer lugar donde debes mirar. Es la solución al error base datos PrestaShop más habitual.

Causa #2: El servidor de la base de datos no es "localhost"

Otro motivo muy común, especialmente en entornos Plesk, es que el host de la base de datos no sea localhost. A veces, Plesk configura un host específico como localhost o la dirección IP del servidor (por ejemplo, 127.0.0.1), pero en otros casos puede ser un nombre de host interno.

Pasos para verificarlo:

Ve a Plesk > Bases de datos y selecciona tu base de datos.
Busca la sección "Acceso remoto" o "Host remoto". Aquí verás la dirección del servidor de base de datos. A menudo es localhost, pero puede ser algo como mysql.example.com o una IP.
Compara este valor con el que tienes en tu archivo parameters.php en el campo 'database_host'.

[INFO] Si tu base de datos está alojada en el mismo servidor que tu web, lo normal es que sea localhost. Si tienes una arquitectura más compleja (base de datos en un servidor separado), el valor será diferente. Plesk te muestra el valor exacto que debes usar.

Causa #3: Problemas con el usuario de la base de datos o permisos

A veces, el problema no es la contraseña, sino que el usuario de la base de datos no tiene los permisos necesarios para acceder a ella, o que el usuario ha sido eliminado o bloqueado.

Cómo comprobarlo en Plesk:

Ve a Plesk > Bases de datos y haz clic en tu base de datos.
En la pestaña "Usuarios", verás una lista de usuarios asociados. Asegúrate de que el usuario que tienes en parameters.php aparece en esa lista.
Haz clic en el usuario y verifica que tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). Lo más fácil es marcar la casilla "Todos los privilegios".

[WARNING] Si el usuario no aparece en la lista, no podrá conectarse. Puedes añadirlo de nuevo, pero necesitarás saber la contraseña que se configuró originalmente. Si no la recuerdas, la solución más segura es crear un nuevo usuario y actualizar el archivo parameters.php con sus datos.

Causa #4: El servidor de base de datos está caído o sobrecargado

Aunque es menos frecuente, el servidor MySQL/MariaDB puede estar experimentando problemas. Esto puede deberse a un pico de tráfico, un fallo del sistema o una configuración incorrecta.

¿Cómo saber si es esto?

Entra en Plesk > Herramientas y utilidades > Gestor de procesos (o "Monitor de procesos").
Busca procesos de mysqld o mariadbd. Si no aparecen, el servicio está caído.
Si el servicio está caído, intenta iniciarlo. Ve a Plesk > Herramientas y utilidades > Servicios. Busca el servicio MySQL/MariaDB y haz clic en "Iniciar".

[TIP] Si el servicio se cae constantemente, puede ser un problema de configuración o falta de recursos (RAM). En ese caso, te recomendamos contactar con tu proveedor de hosting para que revisen el servidor.

Causa #5: Archivos corruptos de PrestaShop (Actualización incompleta)

Si has intentado actualizar PrestaShop o has movido archivos manualmente, es posible que el archivo parameters.php esté corrupto o incompleto. Esto puede provocar que no se lean bien las credenciales.

Solución:

Haz una copia de seguridad del archivo parameters.php actual (por si acaso).
Reemplázalo con una versión limpia. Puedes descargar una copia de tu versión de PrestaShop desde el sitio oficial y extraer el archivo de la carpeta app/config/.
Edita el archivo nuevo con tus credenciales reales (las de Plesk) y súbelo al servidor.

[WARNING] Esta es una solución más técnica. Asegúrate de que el archivo que descargas coincide exactamente con la versión de tu PrestaShop. Un archivo de una versión diferente puede causar errores incompatibles.

Causa #6: Problemas con el puerto de conexión

Por defecto, MySQL usa el puerto 3306. Sin embargo, en algunos servidores Plesk configurados por seguridad, el puerto puede ser diferente. Si tu proveedor ha cambiado el puerto, necesitarás especificarlo.

Dónde ver el puerto:

En Plesk, ve a Herramientas y utilidades > Configuración de servidor o busca la configuración de MySQL.
Busca el parámetro "Puerto" o "Port". Si no es 3306, anótalo.
En tu archivo parameters.php, busca la línea 'database_port' y cámbiala al valor correcto.

[INFO] Si no ves la línea 'database_port' en tu archivo, puedes añadirla. El formato es: 'database_port' => '3306', (reemplaza 3306 con el puerto correcto).

Solución avanzada: Usar la consola de Plesk (SSH)

Si los pasos anteriores no funcionan y tienes acceso SSH, puedes probar a conectarte manualmente a la base de datos para verificar que las credenciales son correctas.

Abre una terminal (en Windows puedes usar PuTTY) y conéctate a tu servidor.
Ejecuta el siguiente comando (reemplaza usuario y nombre_base_datos con tus datos):

mysql -u usuario -p nombre_base_datos

Te pedirá la contraseña. Si la conexión es exitosa, verás el prompt de MySQL (mysql>). Escribe EXIT; para salir.

[WARNING] Si este comando te da un error, significa que las credenciales son incorrectas o el servidor de base de datos no está accesible desde esa vía. Si la conexión funciona aquí pero no en tu web, el problema está en el archivo parameters.php.

¿Cómo evitar este error en el futuro?

Prevenir es mejor que curar. Aquí tienes algunos consejos:

Cambia las contraseñas desde Plesk: Cuando cambies la contraseña de la base de datos desde Plesk, actualiza inmediatamente el archivo parameters.php.
Haz copias de seguridad: Antes de hacer cualquier cambio en archivos de configuración o actualizaciones, realiza una copia de seguridad completa de tu tienda y de la base de datos.
Documenta tus credenciales: Guarda en un lugar seguro (como un gestor de contraseñas) las credenciales de tu base de datos. Esto te ahorrará tiempo en el futuro.
No edites archivos directamente en producción: Si es posible, descarga el archivo, edítalo en local y súbelo de nuevo. Esto evita errores de sintaxis.

Preguntas frecuentes (FAQ)

¿Por qué me sale este error después de cambiar la contraseña en Plesk?

Porque PrestaShop guarda la contraseña en el archivo parameters.php. Si no actualizas ese archivo con la nueva contraseña, no podrá conectarse. Es la causa más común del error base datos PrestaShop.

¿El error puede deberse a un problema del servidor?

Sí, aunque es menos común. El servicio de MySQL/MariaDB puede estar caído o sobrecargado. Revisa el estado del servicio en Plesk.

¿Qué hago si he probado todo y sigo sin poder conectar?

Si has verificado las credenciales, el host, los permisos y el servicio, y el problema persiste, te recomendamos contactar con tu proveedor de hosting. Ellos pueden revisar los logs del servidor y la configuración de red, ya que puede haber un problema más profundo que requiera intervención técnica.

¿Es necesario saber programación para solucionar esto?

No. Siguiendo esta guía paso a paso, puedes solucionar la mayoría de los casos. Solo necesitas ser cuidadoso al editar los archivos y tener acceso al panel de Plesk.

¿Puedo usar un plugin o módulo para arreglar esto?

No existe un plugin que arregle esto automáticamente. La solución es siempre manual, editando el archivo parameters.php o ajustando la configuración en Plesk.

¿Qué pasa si solo tengo acceso a "Syspanel" (HestiaCP) y no a Plesk?

Si tu panel es "Syspanel", el proceso es muy similar. El acceso se realiza a través del puerto 2106 (https://tu-dominio.com:2106). Dentro de Syspanel, busca la sección de "Bases de datos" para ver las credenciales. El archivo a editar en PrestaShop es el mismo: app/config/parameters.php. La lógica es idéntica: verificar que las credenciales en el archivo coinciden con las del panel.

Esperamos que esta guía te haya sido de gran ayuda y que hayas podido resolver el problema. Recuerda que la paciencia y la meticulosidad son tus mejores aliadas. Si has llegado hasta aquí, ya tienes el conocimiento necesario para enfrentarte a este error. ¡Mucha suerte con tu tienda!