Error base datos PrestaShop Plesk | Solución rápida

¡Tranquilo! Si estás viendo un mensaje de error de conexión a base de datos en tu tienda PrestaShop alojada en Plesk, no te preocupes. Es uno de los problemas más comunes y, por suerte, casi siempre tiene una solución sencilla. En esta guía extensa y paso a paso, te voy a explicar exactamente qué significa este error, por qué ocurre y cómo resolverlo tú mismo, incluso si no eres un experto técnico.

Vamos a desglosar el error base datos PrestaShop Plesk en partes fáciles de entender. Al final, serás capaz de diagnosticar y arreglar la conexión base datos PrestaShop sin necesidad de llamar a un especialista. Y si el problema persiste, te daré las claves para que sepas exactamente qué información proporcionar al soporte técnico.

¿Qué significa exactamente "Error de conexión a la base de datos"?

Imagina que tu tienda PrestaShop es una biblioteca enorme. La base de datos es el almacén donde guardas todos los libros (productos, clientes, pedidos, configuraciones). Para que la biblioteca funcione, los bibliotecarios (PrestaShop) necesitan una llave especial (usuario y contraseña) y saber en qué estantería está todo (nombre de la base de datos y servidor). Si algo falla en esa llave o en la dirección del almacén, los bibliotecarios no pueden trabajar y tu tienda se queda en blanco.

El error típico que verás en pantalla es algo como:
"Error de conexión a la base de datos: Link to database cannot be established" o simplemente una pantalla en blanco.

Esto no significa que hayas perdido tus datos. Solo significa que PrestaShop no puede "hablar" con su almacén en este momento.

Causas principales del error de conexión en Plesk

Antes de lanzarnos a arreglarlo, es bueno saber qué lo provoca. Las causas más frecuentes en un entorno Plesk son:

Cambio de contraseña de la base de datos: Es la causa número 1. Si cambiaste la contraseña de tu base de datos desde Plesk, pero no actualizaste el archivo de configuración de PrestaShop, se produce el error.
Corrupción o modificación del archivo settings.inc.php: Este archivo es el "mapa" que usa PrestaShop para encontrar la base de datos. Si se daña, se borra por accidente o se modifica incorrectamente, la conexión falla.
Problemas con el servidor de base de datos (MySQL/MariaDB): El servicio de bases de datos puede estar detenido, sobrecargado o haber cambiado su dirección (por ejemplo, si migraste el sitio a otro servidor).
Permisos incorrectos del usuario de la base de datos: El usuario que usa PrestaShop puede no tener todos los permisos necesarios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) sobre la base de datos.
Archivos o caché corruptos de PrestaShop: A veces, el propio PrestaShop guarda información desactualizada que interfiere con la conexión.

Solución paso a paso: Cómo resolver el error base datos PrestaShop Plesk

Vamos a ir de lo más simple a lo más complejo. Sigue estos pasos en orden. No te saltes ninguno hasta que tu tienda vuelva a funcionar.

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

Lo primero es asegurarnos de que el motor de bases de datos esté funcionando.

Accede a tu panel de control Plesk.
Ve a Herramientas y configuración (en la barra lateral izquierda, a veces como un icono de engranaje).
Busca la sección Servicios y haz clic en Administrador de servicios.
Localiza el servicio MySQL o MariaDB (dependiendo de cuál uses).
Asegúrate de que su estado sea "Corriendo" o "Active". Si está detenido, selecciona "Iniciar".

[TIP] Si no ves esta opción, es posible que tu plan de hosting no te permita gestionar servicios. En ese caso, contacta con tu proveedor de hosting y pídeles que verifiquen que MySQL/MariaDB está funcionando.

Paso 2: Comprobar las credenciales en el archivo settings.inc.php

Este es el paso más importante. Vamos a revisar el "mapa" de PrestaShop.

Conéctate a tu servidor mediante FTP (FileZilla, por ejemplo) o usa el Administrador de Archivos de Plesk.
Navega hasta la carpeta donde está instalado PrestaShop. Normalmente es httpdocs o public_html.
Dentro de esa carpeta, busca la carpeta app/config/.
Dentro de app/config/, localiza el archivo parameters.php (en PrestaShop 1.7 y 8.x). Si usas una versión muy antigua (1.6), el archivo se llama settings.inc.php y está en la raíz o en config/.
Descarga una copia de seguridad de este archivo a tu ordenador.
Ahora, ábrelo con un editor de texto plano (como Notepad++ o Sublime Text). No uses Word ni WordPad.

Busca las siguientes líneas (el nombre exacto puede variar ligeramente):

'database_host' => 'localhost',
'database_name' => 'tu_nombre_de_bd',
'database_user' => 'tu_usuario_de_bd',
'database_password' => 'tu_contraseña_de_bd',

En versiones 1.6, sería algo como:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_nombre_de_bd');
define('_DB_USER_', 'tu_usuario_de_bd');
define('_DB_PASSWD_', 'tu_contraseña_de_bd');

Anota estos valores o compáralos con los que tienes en Plesk. Para obtener los datos correctos:
- Ve a Plesk > Bases de datos.
- Busca la base de datos de tu tienda. Ahí verás el nombre de la base de datos y el usuario asociado.
- Si no recuerdas la contraseña, puedes cambiarla desde Plesk (Botón "Cambiar contraseña" en la misma pantalla). Si la cambias, tendrás que actualizarla también en el archivo parameters.php.

[WARNING] El database_host casi siempre es localhost. Si tu hosting usa un servidor de bases de datos externo, te lo habrán proporcionado. No lo cambies a menos que estés seguro.

Paso 3: Sincronizar la contraseña (el error más común)

Si has cambiado la contraseña en Plesk, o sospechas que puede ser incorrecta:

Ve a Plesk > Bases de datos.
Haz clic en el nombre de la base de datos de tu tienda.
En la siguiente pantalla, verás la opción "Cambiar contraseña".
Establece una contraseña nueva, segura, pero que puedas recordar o guardar en un gestor de contraseñas. Anótala.
Ahora, vuelve al Paso 2 y edita el archivo parameters.php (o settings.inc.php).
Reemplaza el valor de database_password por la nueva contraseña que acabas de crear.
Guarda el archivo y súbelo de nuevo al servidor (sobrescribiendo el antiguo).

[INFO] Después de cambiar la contraseña y el archivo, es posible que necesites regenerar la caché de PrestaShop. Puedes hacerlo desde el back office (si logras acceder) o borrando manualmente la carpeta /var/cache/ dentro de la instalación de PrestaShop (no borres la carpeta en sí, solo su contenido).

Paso 4: Verificar los permisos del usuario de la base de datos

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos para hacer su trabajo.

En Plesk, ve a Bases de datos.
Haz clic en el nombre de tu base de datos.
Busca la sección "Usuarios" o "Usuarios de base de datos".
Verás el usuario asociado. Debería tener un check o indicar que tiene "Todos los privilegios".
Si ves que faltan permisos, puedes seleccionar la opción "Conceder todos los privilegios" o marcar manualmente las opciones necesarias: SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, etc.
Guarda los cambios.

Paso 5: Revisar la configuración del servidor (host)

Si tu tienda fue migrada recientemente o tu proveedor cambió algo, el database_host puede haber cambiado.

Pregunta a tu proveedor de hosting cuál es la dirección del servidor de bases de datos. Normalmente es localhost, pero a veces usan direcciones como 127.0.0.1 o un nombre de servidor específico (ej: mysql.tudominio.com).
Si te dan una dirección diferente, actualízala en el archivo parameters.php (Paso 2).

Paso 6: Solucionar problemas de caché y archivos corruptos

Si todo lo anterior está correcto, el problema puede ser interno de PrestaShop.

Borra la caché manualmente: Conéctate por FTP y elimina todo el contenido de la carpeta /var/cache/ (en PrestaShop 1.7+) o /cache/ (en 1.6). No borres las carpetas, solo los archivos y subcarpetas de su interior.
Desactiva la caché de Smarty (si puedes acceder al back office): Si tienes suerte y puedes entrar al panel de administración, ve a Parámetros de la tienda > Rendimiento > Caché de Smarty y pónlo en "Forzar compilación" y "No usar caché". Guarda y recarga la tienda.
Verifica la integridad de los archivos: Si tienes acceso a SSH, puedes ejecutar un comando para verificar la integridad de los archivos de PrestaShop (esto ya es más avanzado). Una opción más sencilla es reinstalar los archivos de PrestaShop (sin tocar la base de datos ni la carpeta /themes/ ni /modules/). Descarga una copia limpia de la misma versión de PrestaShop, sube los archivos (sobrescribiendo) y vuelve a probar.

Paso 7: Revisar el error específico en los logs

Si nada funciona, los logs de error te darán la pista definitiva.

En Plesk, ve a Sitios web y dominios.
Haz clic en "Mostrar más" o en el nombre de tu dominio.
Busca la sección "Logs" o "Registros".
Revisa el log de errores de Apache/nGinx y el log de MySQL.
Busca entradas que contengan palabras como "database", "connection", "access denied", "prestashop". El mensaje de error suele ser muy descriptivo (ej: "Access denied for user 'usuario'@'localhost' (using password: YES)" indica que la contraseña es incorrecta; "Unknown database 'nombre_bd'" indica que el nombre de la base de datos está mal).

FAQ: Preguntas frecuentes sobre el error de conexión

P: ¿El error puede deberse a un plugin o módulo?
R: Sí, aunque es menos común. Un módulo mal programado puede forzar una conexión incorrecta. Si el error aparece justo después de instalar un módulo, desactívalo renombrando su carpeta en /modules/ (desde FTP) y comprueba si se soluciona.

P: ¿Pierdo mis datos si tengo este error?
R: No. El error es de conexión, no de pérdida de datos. Tus productos, clientes y pedidos siguen en la base de datos. Una vez restablezcas la conexión, todo volverá a la normalidad.

P: ¿Y si uso Syspanel (HestiaCP) en lugar de Plesk?
R: El procedimiento es muy similar. En Syspanel, accedes por el puerto 2106 (ej: https://tu-dominio:2106). Luego buscas la sección Base de datos y verificarás los mismos parámetros: nombre, usuario y contraseña. El archivo de configuración de PrestaShop es el mismo (parameters.php). La lógica es idéntica.

P: He seguido todos los pasos y sigue sin funcionar. ¿Qué hago?
R: Es hora de contactar al soporte técnico de tu hosting. Diles exactamente:

Que tu tienda PrestaShop muestra un error de conexión a base de datos.
Que has verificado que el servicio MySQL/MariaDB está activo en Plesk.
Que has comprobado que las credenciales en parameters.php coinciden con las de Plesk.
Proporciona el mensaje de error exacto que ves en pantalla (si aparece alguno) o el error que encuentres en los logs.
Con esa información, ellos podrán diagnosticar si es un problema del servidor (firewall, límites de conexión, etc.) o algo más profundo.

[WARNING] Nunca compartas tu contraseña de base de datos en foros públicos. Si necesitas ayuda, proporciona los mensajes de error, pero nunca las claves.

Resumen final

El error base datos PrestaShop Plesk suena aterrador, pero en el 90% de los casos se soluciona actualizando la contraseña en el archivo parameters.php. Es un problema de comunicación. Siguiendo esta guía paso a paso, podrás diagnosticar y resolver la conexión base datos PrestaShop tú mismo.

Recuerda el orden: verifica el servicio, comprueba las credenciales en el archivo de configuración, sincroniza la contraseña, revisa los permisos y, por último, limpia la caché. Si todo falla, los logs de Plesk son tus mejores aliados. ¡No te rindas! Tu tienda volverá a estar online en minutos.