Error conexión BD PrestaShop en Plesk | Solución rápida

¿Por qué aparece el error "PrestaShop no puede conectarse a la base de datos" en Plesk?

Este es uno de los errores más comunes y, a la vez, más frustrantes para cualquier persona que administra una tienda online. Ver un mensaje como "PrestaShop no puede conectarse a la base de datos" o un error similar en plena campaña de ventas puede parecer un desastre absoluto, pero no te preocupes: en la gran mayoría de los casos, la solución es más sencilla de lo que parece y no requiere ser un experto en programación.

Cuando tu tienda PrestaShop pierde la conexión con su base de datos MySQL, la tienda deja de funcionar por completo. Las causas pueden ir desde un cambio de contraseña, un fallo en el servidor, hasta una configuración incorrecta en el archivo de conexión. En este artículo, te voy a guiar paso a paso para diagnosticar y solucionar el error de conexión a la base de datos de PrestaShop en Plesk, con un lenguaje claro y directo para que lo hagas tú mismo sin necesidad de abrir un ticket de soporte (aunque al final te diré cuándo sí conviene).

Vamos a ello.

Paso 1: Entender el mensaje de error y qué significa

Antes de tocar nada, es importante que sepas qué está ocurriendo. Cuando PrestaShop no puede conectarse a la base de datos, normalmente verás uno de estos mensajes:

"Error de conexión a la base de datos"
"PrestaShop no puede conectarse a la base de datos"
"Link to database cannot be established"
"Error prestashop plesk"

Este mensaje significa que el archivo de configuración de PrestaShop (que se llama parameters.php o settings.inc.php según la versión) tiene unos datos de acceso a MySQL que no coinciden con los que el servidor Plesk está aceptando actualmente.

[INFO]
El archivo parameters.php se encuentra en la carpeta app/config/ de tu instalación de PrestaShop. Es el "cerebro" que guarda la dirección del servidor de base de datos, el nombre de usuario, la contraseña y el nombre de la base de datos.

Paso 2: Comprobar si el servicio de MySQL está activo en Plesk

A veces, el problema no es tu tienda, sino el servidor. Si el servicio de MySQL se ha detenido o ha fallado, ninguna aplicación podrá conectarse. En Plesk, esto es muy fácil de revisar.

Cómo verificar el estado de MySQL en Plesk

Accede a tu panel de control de Plesk (normalmente en https://tu-dominio.com:8443).
En el menú lateral izquierdo, busca la sección "Herramientas y utilidades" o "Configuración del servidor".
Haz clic en "Servicios" o "Administración de servicios" (dependiendo de la versión de Plesk).
Busca en la lista el servicio llamado "MySQL" o "MariaDB".
Verifica que el estado sea "Activo" o "Corriendo".

Si el servicio está detenido, simplemente haz clic en el botón de iniciar o reiniciar. Espera unos segundos y vuelve a cargar tu tienda.

[WARNING]
Si reinicias el servicio MySQL, es posible que otras aplicaciones o sitios web en el mismo servidor se desconecten durante unos segundos. Es un proceso normal y se restablecerá automáticamente.

Paso 3: Revisar las credenciales de la base de datos en Plesk

Si el servicio MySQL está activo, el siguiente paso es verificar que las credenciales que tiene PrestaShop sean las correctas. Es muy común que, tras una renovación de dominio o una migración, la contraseña de la base de datos haya cambiado.

¿Cómo encontrar los datos de tu base de datos en Plesk?

En Plesk, entra en tu suscripción o dominio.
Busca la sección "Bases de datos" en el menú de la izquierda.
Ahí verás el nombre de la base de datos (suele ser algo como tuusuario_bd).
También verás el nombre de usuario de la base de datos (normalmente es el mismo que el de la base, o un prefijo similar).
Si no recuerdas la contraseña, puedes hacer clic en el usuario y seleccionar "Cambiar contraseña" para establecer una nueva.

[TIP]
Cuando cambies la contraseña de la base de datos en Plesk, automáticamente se actualiza el acceso para todas las aplicaciones que usen esa base de datos... pero no para PrestaShop. PrestaShop guarda la contraseña en su archivo de configuración, así que tendrás que actualizarla manualmente (lo veremos en el siguiente paso).

Paso 4: Editar el archivo de configuración de PrestaShop

Este es el paso clave para solucionar el error de conexión a la base de datos de PrestaShop. Vamos a editar el archivo parameters.php para asegurarnos de que los datos coinciden con los de Plesk.

Acceso al archivo mediante el Administrador de archivos de Plesk

Puedes hacerlo desde el propio panel de Plesk sin necesidad de usar FTP.

En Plesk, ve a tu dominio y haz clic en "Administrador de archivos".
Navega hasta la carpeta httpdocs (o la carpeta donde tengas instalado PrestaShop).
Entra en la carpeta app.
Entra en la carpeta config.
Busca el archivo parameters.php y haz clic derecho sobre él para seleccionar "Editar".

Qué debes modificar en `parameters.php`

Dentro del archivo, verás un array con varias líneas. Las que nos interesan son las que están dentro de 'database_host', 'database_name', 'database_user' y 'database_password'.

Debería verse algo así (aunque con otros valores):

'database_host' => 'localhost',
'database_name' => 'tuusuario_bd',
'database_user' => 'tuusuario_bd',
'database_password' => 'tucontraseña',

Ahora, compara estos valores con los que tienes en Plesk:

database_host: Normalmente es localhost, pero si tu base de datos está en otro servidor, deberás poner la IP o el nombre del servidor.
database_name: Debe coincidir EXACTAMENTE con el nombre que ves en Plesk.
database_user: Debe coincidir con el usuario de la base de datos.
database_password: Debe ser la contraseña actual (la que pusiste en el paso anterior si la cambiaste).

[WARNING]
Ten mucho cuidado al editar este archivo. No borres comas, comillas ni otros valores. Un solo carácter mal puesto puede romper toda la tienda. Si no estás seguro, haz una copia de seguridad del archivo antes de editarlo (puedes descargarlo a tu ordenador).

Guardar cambios y probar

Una vez que hayas corregido los valores, guarda el archivo y vuelve a cargar tu tienda. En la mayoría de los casos, con esto se resuelve el problema.

Paso 5: Limpiar la caché de PrestaShop

A veces, aunque la configuración sea correcta, PrestaShop guarda información antigua en su caché y sigue mostrando el error. Es como cuando cambias una contraseña y el navegador te sigue pidiendo la antigua porque recuerda la sesión anterior.

Cómo limpiar la caché manualmente

Ve a la carpeta var/cache dentro de tu instalación de PrestaShop (en versiones antiguas es cache).
Dentro de esa carpeta, verás subcarpetas con nombres como dev y prod.
Entra en la carpeta prod (o dev si estás en modo desarrollo).
Borra TODOS los archivos que haya dentro de esa carpeta. No te preocupes, PrestaShop los regenerará automáticamente.

[INFO]
Si no puedes borrar los archivos desde el Administrador de archivos de Plesk, puedes conectarte por FTP y borrarlos desde tu ordenador. Asegúrate de que tu cliente FTP tenga permisos de escritura.

Paso 6: Comprobar los permisos de la base de datos

Otro motivo común por el que PrestaShop no conecta MySQL es que el usuario de la base de datos no tiene permisos suficientes. Esto puede pasar si alguien ha modificado los privilegios en Plesk.

Cómo verificar los permisos en Plesk

Ve a tu base de datos en Plesk.
Haz clic en el nombre de usuario de la base de datos.
Verás una lista de privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).
Asegúrate de que la opción "TODOS LOS PRIVILEGIOS" esté marcada o, como mínimo, que estén marcados los privilegios básicos.

Si no están todos marcados, actívalos y guarda los cambios. Después, limpia la caché de PrestaShop de nuevo.

Paso 7: Verificar si el problema es un fallo de red o de servidor

Si has seguido todos los pasos anteriores y el error persiste, es posible que haya un problema a nivel de red o que el servidor de base de datos esté bloqueando conexiones externas.

Prueba rápida desde el panel de Plesk

En Plesk, ve a "Herramientas y utilidades" > "Administración de servidores".
Busca la opción "Comprobar conexión a la base de datos" o "Probar conexión MySQL".
Introduce los datos de tu base de datos y ejecuta la prueba.

Si la prueba falla, el problema es del servidor. Si la prueba es exitosa, el problema está en la configuración de PrestaShop (vuelve a revisar los pasos 3 y 4).

Paso 8: Solución avanzada: editar el archivo `.env` (versiones recientes)

En las versiones más modernas de PrestaShop (1.7.7+), la configuración de la base de datos también se puede guardar en un archivo llamado .env en la raíz de la instalación.

Ve al Administrador de archivos de Plesk.
Busca el archivo .env en la carpeta raíz (puede estar oculto, activa la opción "Mostrar archivos ocultos").
Ábrelo y busca las líneas que empiezan por DATABASE_.
Corrige los valores de la misma manera que en el archivo parameters.php.

[TIP]
No todos los archivos .env son iguales. Si no encuentras las líneas DATABASE_, es que tu versión usa solo el archivo parameters.php. No edites nada que no entiendas.

Paso 9: Revisar los logs de error de Plesk

Si nada funciona, los logs de error son tu mejor amigo. Plesk guarda registros de lo que está pasando en el servidor.

Dónde encontrar los logs en Plesk

Ve a tu dominio en Plesk.
Haz clic en "Registros" o "Logs".
Busca el archivo de log de errores de PHP o de MySQL.
Ábrelo y busca errores recientes relacionados con la conexión a la base de datos.

Los mensajes de error te darán pistas más precisas, como "Access denied for user" (usuario denegado) o "Unknown database" (base de datos inexistente).

Paso 10: Cuándo contactar con el soporte técnico

Si has llegado hasta aquí y el error "PrestaShop no puede conectarse a la base de datos" sigue apareciendo en Plesk, es momento de pedir ayuda profesional. Esto es especialmente recomendable si:

No te sientes cómodo editando archivos de configuración.
El error ocurre en un servidor compartido y no tienes acceso completo a Plesk.
Sospechas que el problema es a nivel de servidor (hardware, red, etc.).

En ese caso, contacta con tu proveedor de hosting y menciona que has seguido los pasos de configuración básicos. Les ahorrarás tiempo y te ayudarán más rápido.

Preguntas frecuentes (FAQ)

¿Qué significa "host" en la configuración de la base de datos?

El host es la dirección del servidor donde está alojada la base de datos. En la mayoría de los casos en Plesk, es localhost, pero a veces puede ser una IP como 127.0.0.1 o un nombre de servidor.

¿Por qué mi tienda funcionaba ayer y hoy da este error?

Puede ser por varias razones: un cambio de contraseña automático, una actualización de Plesk que reinició servicios, o un fallo temporal del servidor. Sigue los pasos en orden y lo resolverás.

¿Es seguro cambiar la contraseña de la base de datos desde Plesk?

Sí, es seguro, pero recuerda que tendrás que actualizar la contraseña en el archivo parameters.php de PrestaShop después de hacerlo. De lo contrario, la tienda dejará de funcionar.

¿Puedo evitar este error en el futuro?

Sí. Te recomiendo que guardes tus credenciales de base de datos en un lugar seguro y que hagas copias de seguridad periódicas del archivo parameters.php. También es buena idea no cambiar contraseñas sin actualizar inmediatamente la configuración de PrestaShop.

Conclusión

El error "PrestaShop no puede conectarse a la base de datos" en Plesk es un problema común, pero con una solución bastante accesible. Siguiendo estos pasos, desde comprobar el estado del servicio MySQL hasta editar el archivo de configuración, podrás recuperar tu tienda en pocos minutos.

Recuerda siempre hacer una copia de seguridad antes de modificar archivos importantes y no dudes en buscar ayuda profesional si lo necesitas. Tu tienda online es una parte vital de tu negocio, y mantenerla funcionando es una prioridad.

Espero que esta guía te haya sido de ayuda. Si tienes alguna duda, déjala en los comentarios (si tu plataforma lo permite) o contacta con tu proveedor de hosting. ¡Buena suerte y a vender!