Errores de conexión a base de datos en Plesk: Soluciones rápidas

¿Tu sitio web está mostrando un mensaje de error como "Error al establecer conexión con la base de datos" o "Cannot connect to MySQL server"? No te preocupes, es una de las incidencias más comunes en Plesk y, por suerte, casi siempre tiene una solución sencilla.

En este artículo, te guiaré paso a paso para que puedas solucionar errores de conexión a base de datos en Plesk. Vamos a ver las causas más frecuentes, cómo diagnosticarlas y cómo arreglarlas, incluso si no eres un experto técnico.

¿Por qué ocurre un error de conexión a la base de datos?

Cuando tu sitio web intenta comunicarse con la base de datos (por ejemplo, MySQL o MariaDB), necesita cuatro datos clave:

El nombre de la base de datos.
El nombre de usuario.
La contraseña.
El servidor (normalmente localhost o una IP).

Si alguno de estos datos es incorrecto, o si el servidor de bases de datos no está funcionando, verás el error. Las causas más habituales son:

Contraseña incorrecta en el archivo de configuración del sitio (por ejemplo, wp-config.php en WordPress).
El servicio de base de datos (MySQL/MariaDB) está detenido o caído.
El usuario de la base de datos no tiene permisos sobre ella.
El archivo de configuración tiene un error de sintaxis o apunta a un servidor equivocado.
La base de datos se ha corrompido o ha superado el límite de espacio.

Vamos a resolverlo.

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

Lo primero es asegurarte de que MySQL o MariaDB esté funcionando. Si el servicio está caído, nada más funcionará.

Cómo comprobarlo desde Plesk

Inicia sesión en Plesk (normalmente accedes a través de https://tudominio.com:8443).
Ve a Herramientas y Configuración (en el menú de la izquierda).
Busca la sección Servicios y haz clic en Administración de Servicios.
Busca la fila de MySQL (o MariaDB). Verás un indicador verde si está activo. Si está rojo o amarillo, el servicio está caído.

Cómo reiniciar el servicio

Si ves que está detenido, haz clic en el botón Iniciar o Reiniciar. Si no aparece, puedes usar la terminal (SSH) o pedir a tu hosting que lo haga.

[TIP]: Si no tienes acceso a la terminal, contacta con tu proveedor de hosting y diles: "Por favor, reinicia el servicio MySQL en mi servidor Plesk". Ellos lo harán en segundos.

Paso 2: Revisa las credenciales en el archivo de configuración de tu sitio

El error más común es tener mal escrita la contraseña o el nombre de usuario en el archivo que conecta tu web con la base de datos.

Para sitios WordPress

El archivo se llama wp-config.php y está en la raíz de tu sitio (carpeta httpdocs o public_html).

Accede a Plesk > Archivos (en el panel de tu dominio).
Busca wp-config.php y haz clic derecho > Editar.
Busca estas líneas:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña');
define('DB_HOST', 'localhost');

Comprueba que DB_NAME, DB_USER y DB_PASSWORD coincidan exactamente con los datos de tu base de datos en Plesk. OJO: las mayúsculas y minúsculas importan.
El DB_HOST normalmente es localhost. Si tu hosting usa un servidor remoto, te lo habrán indicado.

[WARNING]: No edites nada más. Un solo carácter mal puede romper todo el sitio.

Para otros CMS (Joomla, Drupal, etc.)

El principio es el mismo: busca el archivo de configuración (suele llamarse configuration.php, settings.php o similar) y verifica las credenciales.

Paso 3: Verifica los permisos del usuario de la base de datos en Plesk

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos para acceder a la base de datos. Esto pasa si borraste y recreaste la base de datos, o si el usuario fue creado para otra.

En Plesk, ve a Bases de Datos (en el panel de tu dominio).
Haz clic en el nombre de la base de datos que quieras revisar.
Verás una lista de Usuarios asociados. Si el usuario que usas en tu web no aparece, debes añadirlo.
Para añadirlo: haz clic en Añadir Usuario y escribe el mismo nombre de usuario y contraseña que tienes en tu archivo de configuración.
Marca la casilla Conceder todos los privilegios (o selecciona los que necesites, generalmente todos para un sitio web).

[INFO]: Si el usuario ya existe pero no tiene permisos, puedes editarlo y marcar todos los privilegios.

Paso 4: Comprueba el nombre del servidor de la base de datos

Aunque casi siempre es localhost, algunos servidores usan un socket o una IP específica. Si tu archivo de configuración dice localhost pero el servicio está configurado para escuchar en un socket diferente, fallará.

Cómo saber el host correcto

En Plesk, ve a Bases de Datos.
Al lado del nombre de tu base de datos, verás un campo Servidor. Normalmente es localhost:3306 (el puerto por defecto).
Si ves algo como mysql.tudominio.com o una IP, ese es el valor que debes poner en tu archivo de configuración.

[TIP]: Si no estás seguro, prueba con 127.0.0.1 en lugar de localhost. En algunos sistemas, localhost puede no resolverse bien.

Paso 5: Verifica que la base de datos no esté corrupta o llena

Si todo lo anterior está bien, la base de datos podría estar dañada o haber alcanzado su límite de tamaño.

Cómo comprobarlo en Plesk

Ve a Bases de Datos > haz clic en el nombre de tu base.
Busca la opción Comprobar o Reparar (a veces está en el menú de herramientas).
Si ves un error de corrupción, haz clic en Reparar.
También revisa el Tamaño de la base. Si está cerca del límite (por ejemplo, 1 GB en planes básicos), deberás optimizarla o contactar con tu hosting para ampliar el espacio.

[WARNING]: No repares la base de datos si no tienes una copia de seguridad reciente. Aunque es seguro, mejor prevenir.

Paso 6: Prueba la conexión manualmente desde la terminal (SSH)

Si tienes acceso a la terminal, puedes hacer una prueba rápida para descartar que el problema sea de Plesk o del servidor.

Conéctate por SSH a tu servidor.
Ejecuta este comando (reemplaza usuario y nombre_base por los tuyos):

mysql -u usuario -p nombre_base

Te pedirá la contraseña. Escríbela y presiona Enter.
Si ves el prompt mysql> es que la conexión funciona. Si ves un error como Access denied o Can't connect, el problema está en las credenciales o el servicio.

[INFO]: Si no sabes usar SSH, salta este paso. No es obligatorio.

Preguntas Frecuentes (FAQ) sobre errores de conexión en Plesk

1. ¿Por qué veo "Error establishing a database connection" en WordPress?

Es el error más común. Generalmente significa que las credenciales en wp-config.php son incorrectas o que el servicio MySQL está caído. Sigue los pasos 1 y 2 de esta guía.

2. ¿Cómo cambio la contraseña de una base de datos en Plesk?

Ve a Bases de Datos > haz clic en el nombre de la base.
En la lista de usuarios, haz clic en el icono de lápiz al lado del usuario.
Escribe la nueva contraseña y guarda.
Importante: Luego actualiza la contraseña en el archivo de configuración de tu sitio (por ejemplo, wp-config.php).

3. ¿Puedo tener varias bases de datos en un mismo plan de Plesk?

Sí, normalmente puedes crear tantas como necesites, aunque el límite depende de tu proveedor. Cada base de datos es independiente.

4. ¿Qué hago si el error aparece solo a veces (intermitente)?

Puede ser por saturación del servidor o por un límite de conexiones. Contacta con tu hosting para que revisen los logs. También puedes aumentar el límite de conexiones en el archivo de configuración de MySQL (necesitas acceso root).

5. ¿Cómo exportar una base de datos para hacer una copia de seguridad?

En Plesk, ve a Bases de Datos > haz clic en el nombre de la base > Exportar Dump. Descargarás un archivo .sql. Guárdalo en un lugar seguro.

6. ¿Qué diferencia hay entre MySQL y MariaDB en Plesk?

MariaDB es un clon mejorado de MySQL. Ambos funcionan igual para el usuario final. Si tu servidor usa MariaDB, los pasos son idénticos.

7. Mi sitio usa HestiaCP (Syspanel) y no Plesk, ¿me sirve esta guía?

Si tu panel es Syspanel (HestiaCP), el acceso es por el puerto 2106 (por ejemplo, https://tudominio.com:2106). Aunque la interfaz es diferente, los principios son los mismos: revisa el servicio, las credenciales y los permisos. La estructura de archivos es similar.

Consejos finales para evitar futuros errores

Haz copias de seguridad regulares: Programa backups automáticos en Plesk (Herramientas y Configuración > Programador de Tareas).
No compartas contraseñas: Usa contraseñas fuertes y únicas para cada base de datos.
Actualiza tu CMS y plugins: Las versiones antiguas pueden tener errores de conexión.
Monitoriza el espacio: Si tu base de datos crece mucho, contacta con tu hosting para ampliar el límite.

Resumen rápido de solución

Síntoma	Causa probable	Solución
Error "Cannot connect to MySQL"	Servicio caído	Paso 1: Reiniciar MySQL
"Access denied for user"	Contraseña incorrecta	Paso 2: Revisar `wp-config.php`
"Unknown database"	Nombre mal escrito	Paso 2: Verificar DB_NAME
"User does not exist"	Permisos faltantes	Paso 3: Añadir usuario a la base
Error intermitente	Saturación o límites	Contactar con hosting

Si después de seguir todos los pasos el error persiste, contacta con tu proveedor de hosting. Diles que ya revisaste el servicio, las credenciales y los permisos, y que necesitas que revisen los logs del servidor. Ellos podrán ver si hay un problema más profundo, como un fallo en el disco o una configuración incorrecta de Plesk.

Espero que esta guía te haya sido útil. Recuerda que la paciencia es clave: la mayoría de estos errores se solucionan en minutos. ¡Buena suerte!