Error de conexión a base de datos en PrestaShop con Plesk: solución

¿Te has encontrado con la temida pantalla blanca o el 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 errores más comunes y, por suerte, casi siempre tiene una solución sencilla. En esta guía extensa y súper detallada, te voy a explicar paso a paso cómo identificar y solucionar este problema. Vamos a ello.

¿Qué significa el error de conexión a base de datos en PrestaShop?

Cuando ves el mensaje "Error de conexión a base de datos" o "Link to database cannot be established", significa que tu tienda PrestaShop no puede comunicarse con el motor de base de datos (normalmente MySQL o MariaDB). Sin esa conexión, tu tienda no puede cargar productos, clientes, pedidos ni ninguna otra información. Es como si la llave no encajara en la cerradura.

Las causas más habituales son:

Credenciales incorrectas en el archivo de configuración.
El servidor de base de datos está caído o no responde.
El usuario de la base de datos no tiene los permisos necesarios.
El archivo settings.inc.php está dañado o tiene información errónea.
Problemas con el motor de Plesk (por ejemplo, después de una migración o actualización).

Primeros pasos: diagnóstico rápido

Antes de meterte en archivos técnicos, haz estas comprobaciones básicas desde tu panel de Plesk.

1. Verifica que el servicio MySQL/MariaDB esté funcionando

Desde Plesk, puedes comprobar el estado de los servicios.

Inicia sesión en tu panel de Plesk.
Ve a Herramientas y ajustes (en la barra lateral izquierda).
Busca la sección Servicios y haz clic en Gestor de servicios.
Busca el servicio MySQL o MariaDB. Debe aparecer con un círculo verde y el texto "En ejecución".
Si está detenido (círculo rojo), selecciona la casilla y haz clic en el botón Iniciar (el triángulo verde).

[INFO] Si el servicio no arranca, puede que haya un problema de configuración o de recursos. En ese caso, contacta con tu proveedor de hosting.

2. Comprueba las credenciales en PrestaShop

El archivo clave es /config/settings.inc.php (en versiones antiguas de PrestaShop 1.6) o /app/config/parameters.php (en PrestaShop 1.7 y 1.8). Conéctate por FTP o usa el gestor de archivos de Plesk.

Accede al gestor de archivos de Plesk (normalmente en la pestaña Archivos).
Navega hasta la carpeta raíz de tu tienda (por ejemplo, httpdocs o public_html).
Busca el archivo parameters.php (PrestaShop 1.7+) o settings.inc.php (PrestaShop 1.6).
Ábrelo con el editor de texto de Plesk.

Busca estas líneas (en parameters.php se ven así):

'database_host' => 'localhost',
'database_name' => 'tu_base_de_datos',
'database_user' => 'tu_usuario',
'database_password' => 'tu_contraseña',

En settings.inc.php:

define('_DB_SERVER_', 'localhost');
define('_DB_NAME_', 'tu_base_de_datos');
define('_DB_USER_', 'tu_usuario');
define('_DB_PASS_', 'tu_contraseña');

Comprueba que:

database_host suele ser localhost. Si tu base de datos está en otro servidor, tendrás la IP o el nombre de host.
El nombre de la base de datos y el usuario son correctos.
La contraseña no tiene caracteres extraños (como apóstrofes o comillas) que puedan romper la cadena.

[WARNING] Si cambias algo, guarda una copia de seguridad del archivo original por si acaso.

Soluciones paso a paso para el error de base de datos en PrestaShop con Plesk

Si las comprobaciones básicas no resolvieron el problema, sigue estas soluciones ordenadas de la más simple a la más avanzada.

Solución 1: Restablecer la contraseña de la base de datos desde Plesk

A veces, la contraseña almacenada en PrestaShop no coincide con la de Plesk (por ejemplo, si la cambiaste manualmente o hubo una migración).

En Plesk, ve a Bases de datos (en el panel del dominio).
Localiza la base de datos de tu tienda.
Haz clic en el nombre del usuario (o en el icono de llave/editar).
En Contraseña, escribe una nueva (fácil de recordar pero segura) y confírmala.
Haz clic en Aceptar.
Ahora, repite el paso 2 de la sección anterior: edita el archivo parameters.php o settings.inc.php y actualiza la contraseña con la que acabas de crear.
Guarda el archivo y recarga tu tienda.

[TIP] Usa una contraseña sin caracteres especiales conflictivos (solo letras y números) para evitar problemas de escape.

Solución 2: Verificar y corregir los permisos del usuario de la base de datos

El usuario debe tener permisos completos sobre la base de datos.

En Plesk, ve a Bases de datos y haz clic en el nombre de tu base de datos.
Ve a la pestaña Usuarios.
Marca la casilla del usuario que usa PrestaShop y haz clic en Editar.
Asegúrate de que tiene seleccionados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Si no, márcalos todos.
Guarda los cambios.

Solución 3: Reparar la base de datos desde Plesk (phpMyAdmin)

Si la base de datos está corrupta (por ejemplo, tras un corte de luz), puedes repararla.

En Plesk, ve a Bases de datos y haz clic en el nombre de tu base de datos.
Haz clic en phpMyAdmin (se abrirá una nueva ventana).
En phpMyAdmin, selecciona todas las tablas (marca la casilla superior "Seleccionar todo").
En el menú desplegable "Con selección", elige Reparar tabla.
Espera a que termine el proceso. Si alguna tabla no se repara, puede que necesites restaurar una copia de seguridad.

[INFO] Si no ves la opción de reparar, es que las tablas son del motor InnoDB, que se repara de otra forma. En ese caso, contacta con soporte.

Solución 4: Forzar la recarga de la configuración de Plesk

A veces, Plesk guarda en caché los datos de conexión. Puedes forzar una recarga.

Conéctate a tu servidor por SSH (si tienes acceso) o pide a tu hosting que lo haga.
Ejecuta estos comandos (como root o con sudo):

plesk sbin httpdmng --reconfigure-all
plesk repair db

El primer comando reconfigura los virtual hosts, el segundo repara la base de datos interna de Plesk.

[WARNING] Si no tienes acceso SSH, salta esta solución y pasa a la siguiente.

Solución 5: Revisar el archivo .htaccess y la configuración de PHP

Un .htaccess corrupto puede bloquear la conexión a la base de datos.

En el gestor de archivos de Plesk, busca el archivo .htaccess en la raíz de tu tienda.
Si existe, renómbralo a .htaccess_old (para desactivarlo temporalmente).
Recarga tu tienda. Si funciona, el problema está en ese archivo. Puedes regenerarlo desde el back office de PrestaShop (Parámetros de la tienda > Tráfico y SEO > URL amigables > Guardar).
También verifica que la versión de PHP sea compatible con tu PrestaShop. En Plesk, ve a Hosting y DNS > Hosting > PHP y selecciona una versión recomendada (por ejemplo, 7.4 o 8.0 para PrestaShop 1.7).

Solución 6: Migración o reinstalación limpia (último recurso)

Si nada funciona, puede que el archivo de configuración esté tan dañado que sea mejor reinstalar.

Haz una copia de seguridad de los archivos y la base de datos desde Plesk (Bases de datos > copia de seguridad).
Descarga una copia limpia de PrestaShop desde tu área de cliente.
Sube los archivos (sin la carpeta /install y sin sobrescribir /config si quieres mantener la configuración).
Ejecuta el instalador desde tudominio.com/install.
Durante la instalación, elige "Restaurar base de datos" y sube tu copia de seguridad.

[WARNING] Esta solución es drástica. Asegúrate de tener todo respaldado.

Preguntas frecuentes (FAQ) sobre error base de datos PrestaShop y Plesk

P: ¿Por qué aparece el error después de cambiar la contraseña de la base de datos en Plesk?
R: Porque PrestaShop sigue usando la contraseña antigua. Debes actualizar el archivo parameters.php o settings.inc.php con la nueva contraseña.

P: ¿Puedo usar "localhost" siempre como host de la base de datos?
R: En la mayoría de los casos sí, si la base de datos está en el mismo servidor. Si usas un servidor externo, tendrás la IP o el nombre del host.

P: Mi tienda muestra "Error de conexión a base de datos" después de una migración a Plesk. ¿Qué hago?
R: Es muy común. Revisa que el nombre de la base de datos, el usuario y la contraseña en el archivo de configuración coincidan exactamente con los que creaste en Plesk. Además, asegúrate de que el usuario tenga todos los permisos.

P: ¿El error puede deberse a un plugin o módulo?
R: Sí, algunos módulos mal codificados pueden saturar la conexión. Prueba a desactivar todos los módulos desde el back office (si puedes acceder) o renombrando la carpeta /modules a /modules_old por FTP.

P: ¿Cómo sé si mi versión de PrestaShop es compatible con la versión de MySQL de Plesk?
R: PrestaShop 1.6 funciona con MySQL 5.x, PrestaShop 1.7 con MySQL 5.6+ o MariaDB 10.x. En Plesk puedes ver la versión en Herramientas y ajustes > Gestor de servicios > MySQL.

[TIP] Si tienes dudas, contacta con el soporte de tu hosting. Ellos pueden verificar los logs del servidor y darte una solución más precisa.

Conclusión

El error de conexión a base de datos en PrestaShop con Plesk puede ser frustrante, pero siguiendo estos pasos ordenados podrás resolverlo en la mayoría de los casos. Recuerda siempre empezar por lo más simple: verificar credenciales y permisos. Y si todo falla, no dudes en pedir ayuda profesional.

Espero que esta guía te haya sido de gran ayuda. ¡Tu tienda online volverá a funcionar en poco tiempo!