Solucionar error de conexión a base de datos en PrestaShop (Plesk)

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

Cuando tu tienda PrestaShop muestra el temido mensaje de que no puede conectarse a la base de datos, lo que está ocurriendo es que el archivo de configuración de tu tienda (normalmente app/config/parameters.php) no está logrando establecer una conexión con el servidor MySQL o MariaDB que gestiona tus productos, pedidos y clientes.

Este es uno de los errores más comunes en PrestaShop y, afortunadamente, casi siempre tiene solución sin necesidad de ser un experto en programación. Las causas más frecuentes suelen ser:

Contraseña de la base de datos incorrecta o cambiada recientemente.
El usuario de la base de datos no tiene los permisos adecuados.
El nombre de la base de datos o del servidor (host) está mal escrito en el archivo de configuración.
El servicio de MySQL o MariaDB está detenido en tu panel de control Plesk.
La base de datos ha alcanzado su límite de tamaño o está corrupta.
Cambios recientes en las credenciales de acceso al panel de hosting.

Antes de entrar en pánico, respira. En este artículo te voy a guiar paso a paso para que puedas solucionar el error PrestaShop Plesk y volver a tener tu tienda online operativa en pocos minutos.

Paso 1: Verifica que el servicio de base de datos esté activo en Plesk

El primer paso, y el más sencillo, es comprobar que el servidor de bases de datos está funcionando correctamente. A veces, tras una actualización del sistema o un reinicio del servidor, el servicio MySQL puede quedar detenido.

Cómo comprobarlo en Plesk

Accede a tu panel de control Plesk (normalmente en https://tudominio.com:8443).
En el menú lateral izquierdo, busca la sección "Herramientas y ajustes".
Dentro de esa sección, localiza el apartado "Servidor" y haz clic en "Servicios del servidor".
Busca la fila correspondiente a MySQL o MariaDB.
Verifica que el estado aparezca como "activo" o "ejecutándose".

Si el estado es "detenido", haz clic en el botón de inicio (el icono de play) para arrancarlo. Espera unos segundos y vuelve a intentar acceder a tu tienda.

[INFO] Si no encuentras la sección de servicios, es posible que tu plan de hosting no te permita gestionarlos directamente. En ese caso, contacta con tu proveedor de hosting y pídeles que verifiquen el estado del servicio MySQL.

Paso 2: Revisa las credenciales de acceso a la base de datos

El siguiente paso es verificar que los datos de conexión que tiene PrestaShop sean correctos. Este es el origen del error conexión base datos PrestaShop Plesk en la mayoría de los casos.

Localiza el archivo de configuración

PrestaShop guarda los datos de conexión en un archivo llamado parameters.php. Su ubicación exacta depende de la versión que tengas:

PrestaShop 1.7 y versiones superiores: tu-tienda/app/config/parameters.php
PrestaShop 1.6 y versiones anteriores: tu-tienda/config/settings.inc.php

Para acceder a este archivo tienes dos opciones:

Desde el administrador de archivos de Plesk: Dentro de tu panel, ve a "Sitios web y dominios", selecciona tu dominio y haz clic en "Administrador de archivos". Navega hasta la carpeta correspondiente.
Desde FTP: Conecta con tu cliente FTP favorito (FileZilla, por ejemplo) y navega hasta la misma ruta.

Qué datos debes comprobar

Una vez abierto el archivo, busca los parámetros que empiezan por database_. Los campos más importantes son:

database_host: normalmente es localhost o 127.0.0.1.
database_name: el nombre exacto de tu base de datos.
database_user: el usuario que tiene acceso a esa base de datos.
database_password: la contraseña de ese usuario.

[WARNING] No compartas nunca estos datos con nadie. Son las llaves de tu tienda online.

Compara con los datos de Plesk

Ahora ve a tu panel de Plesk y navega hasta "Sitios web y dominios" > "Bases de datos". Ahí verás la lista de todas las bases de datos que tienes creadas.

Haz clic en el nombre de la base de datos que corresponde a tu tienda y revisa:

El nombre de la base de datos debe coincidir exactamente con el que aparece en el archivo de configuración.
El usuario asociado debe ser el mismo.
Si no recuerdas la contraseña, puedes cambiarla desde aquí con el botón "Cambiar contraseña".

Una vez que tengas los datos correctos, actualiza el archivo parameters.php con los nuevos valores y guarda los cambios.

Paso 3: Asegúrate de que el usuario tiene permisos suficientes

A veces las credenciales son correctas, pero el usuario no tiene permisos para acceder a la base de datos desde el servidor donde está alojada tu tienda. Esto puede pasar si la base de datos se ha importado desde otro hosting o si alguien modificó los permisos accidentalmente.

Cómo verificar y otorgar permisos en Plesk

Ve a "Sitios web y dominios" > "Bases de datos".
Haz clic en el icono de "Administrar" (normalmente un icono de usuario o de llave) junto a la base de datos que usa tu PrestaShop.
Se abrirá una ventana con la lista de usuarios que tienen acceso a esa base de datos.
Comprueba que el usuario que aparece en tu archivo parameters.php esté en la lista.
Si no está, añádelo con el botón "Añadir usuario".
Marca la casilla de "Todos los privilegios" para asegurarte de que tiene acceso completo (SELECT, INSERT, UPDATE, DELETE, etc.).

[TIP] Si acabas de cambiar la contraseña en el paso anterior, asegúrate de que el usuario también tenga esa misma contraseña actualizada en los permisos.

Paso 4: Comprueba la conexión desde la línea de comandos (SSH)

Si los pasos anteriores no han funcionado, puede ser útil probar la conexión directamente desde el servidor. Esto nos dirá si el problema es de PrestaShop o del propio servidor de bases de datos.

Conecta por SSH

Abre una terminal en tu ordenador.
Conecta a tu servidor con: ssh usuario@tudominio.com
Una vez dentro, escribe el siguiente comando:

mysql -u NOMBRE_USUARIO -p NOMBRE_BASE_DE_DATOS

Te pedirá la contraseña. Si la conexión es exitosa, verás el prompt de MySQL (mysql>). Si recibes un error, anota el mensaje exacto, ya que nos dará pistas sobre el problema.

Errores comunes en la conexión

"Access denied for user": El usuario o contraseña son incorrectos, o el usuario no tiene permisos para conectarse desde esa dirección IP.
"Unknown database": El nombre de la base de datos no existe. Verifica que esté bien escrito.
"Can't connect to MySQL server": El servicio no está corriendo o el host no es correcto.

[WARNING] Si no te sientes cómodo usando SSH, puedes saltarte este paso. Es una herramienta avanzada y no es imprescindible para resolver el error en la mayoría de los casos.

Paso 5: Restablece el archivo de configuración (solución avanzada)

Si has llegado hasta aquí y nada funciona, puede que el archivo parameters.php esté corrupto o con datos incompletos. En ese caso, podemos regenerarlo.

Copia de seguridad primero

Antes de tocar nada, haz una copia de seguridad del archivo actual. Puedes descargarlo por FTP o simplemente renombrarlo a parameters.php.bak.

Regenera el archivo

Accede a tu tienda a través de la URL de instalación: tudominio.com/install
PrestaShop te ofrecerá la opción de "Reparar la tienda" o "Reinstalar".
Sigue el asistente y cuando llegue al paso de la base de datos, introduce los datos correctos que has verificado anteriormente.
El sistema generará un nuevo archivo parameters.php con la configuración correcta.

[INFO] Este proceso no borra tus datos. Solo regenera los archivos de configuración. Tu base de datos con productos y pedidos permanece intacta.

Paso 6: Limpia la caché de PrestaShop

A veces el error persiste aunque la conexión sea correcta porque PrestaShop guarda en caché datos antiguos de conexión. Limpiar la caché puede resolver el problema de inmediato.

Cómo limpiar la caché sin acceso al panel de administración

Conecta por FTP a tu servidor.
Navega hasta la carpeta var/cache (en PrestaShop 1.7) o cache (en versiones anteriores).
Elimina el contenido de esa carpeta (no la carpeta en sí, solo los archivos que contiene).
Vuelve a intentar acceder a tu tienda.

[TIP] Si no puedes eliminar los archivos por FTP, puedes intentar renombrar la carpeta cache a cache_old. PrestaShop creará una nueva automáticamente.

Preguntas frecuentes (FAQ) sobre este error

¿Por qué mi tienda PrestaShop no conecta BD después de cambiar la contraseña de MySQL desde Plesk?

Es el caso más común. Cuando cambias la contraseña de la base de datos desde Plesk, PrestaShop sigue intentando conectar con la contraseña antigua. Debes actualizar el archivo parameters.php con la nueva contraseña.

¿Qué hago si el error aparece después de migrar mi tienda a otro servidor?

En una migración, los datos de conexión cambian casi siempre. Revisa que el archivo parameters.php contenga los datos del nuevo servidor, especialmente el database_host (que puede ser una IP o un nombre de servidor distinto a localhost).

¿Puedo resolver este error desde el panel de administración de PrestaShop?

No, si el error es de conexión a la base de datos, no podrás acceder al panel de administración. Tendrás que hacerlo desde Plesk o por FTP.

¿Pierdo mis datos si tengo que regenerar el archivo de configuración?

No. El archivo de configuración solo contiene datos de conexión, no datos de tu tienda. Tu base de datos con productos, pedidos y clientes está a salvo.

Consejos finales para evitar este error en el futuro

Para que este problema no se repita, te recomiendo seguir estos hábitos:

Documenta tus credenciales: Guarda en un lugar seguro el nombre de la base de datos, el usuario y la contraseña de cada tienda.
Cambia las contraseñas con cuidado: Si cambias la contraseña en Plesk, actualiza inmediatamente el archivo parameters.php.
Haz copias de seguridad periódicas: Tanto de los archivos como de la base de datos. Esto te permitirá restaurar rápidamente si algo falla.
Mantén PrestaShop actualizado: Las versiones antiguas tienen más probabilidades de dar errores de configuración.

[WARNING] Si después de seguir todos estos pasos el error persiste, puede ser un problema más grave del servidor. Contacta con tu proveedor de hosting y proporciona el mensaje de error exacto y los pasos que has seguido. Ellos podrán revisar los logs del servidor para encontrar la causa raíz.

Resumen rápido: los 3 pasos que resuelven el 90% de los casos

Paso	Acción	Herramienta
1	Verificar que el servicio MySQL está activo	Plesk > Herramientas > Servicios
2	Comparar credenciales entre Plesk y `parameters.php`	Plesk + FTP
3	Actualizar la contraseña o el usuario en `parameters.php`	FTP o Administrador de archivos

Con estos pasos, el error conexión base datos PrestaShop Plesk debería quedar resuelto. Recuerda que la clave está en que los datos de tu archivo de configuración coincidan exactamente con los que tienes en Plesk. Si todo coincide y el servicio está activo, tu tienda volverá a funcionar sin problemas.

Espero que esta guía te haya sido de ayuda. Si tienes alguna duda, deja un comentario y estaré encantado de ayudarte a solucionar el error PrestaShop Plesk de tu tienda online.