Error Conexión Base de Datos WordPress en Plesk: Solución

¿Por qué aparece el error “Error al establecer una conexión a la base de datos” en WordPress con Plesk?

Este es uno de los errores más frustrantes que puedes encontrarte al gestionar un sitio web con WordPress. De repente, tu página deja de cargar y solo ves un mensaje en blanco o con un texto que dice algo como: “Error al establecer una conexión a la base de datos”. No te preocupes, no has perdido tu sitio. Este error indica que WordPress no puede comunicarse con la base de datos donde almacena todo tu contenido, usuarios y configuraciones.

En este artículo, te guiaré paso a paso para solucionar el error conexión base datos WordPress cuando tu sitio está alojado en un servidor con Plesk. Plesk es un panel de control muy popular que facilita la gestión de sitios web, bases de datos y correos. Aunque el error puede parecer técnico, la mayoría de las causas son sencillas de resolver, incluso si no eres un experto.

Causas principales del error “Conexión a la base de datos” en WordPress con Plesk

Antes de lanzarnos a las soluciones, es útil entender qué puede estar fallando. Las causas más comunes son:

Credenciales incorrectas en el archivo wp-config.php.
El servicio MySQL/MariaDB está caído o se ha reiniciado.
La base de datos ha sido eliminada o corrompida.
El usuario de la base de datos no tiene permisos adecuados.
Problemas de IP o firewall que bloquean la conexión.
Actualización de PHP o MySQL que rompe la compatibilidad.
Espacio en disco lleno en el servidor.

En los siguientes pasos, iremos descartando cada una de estas posibilidades.

Paso 1: Verifica que el servicio MySQL esté funcionando en Plesk

El primer paso es asegurarte de que el motor de base de datos (MySQL o MariaDB) esté activo. En Plesk, puedes hacerlo fácilmente.

### Cómo comprobarlo desde el panel de Plesk:

Inicia sesión en Plesk (normalmente accedes a https://tudominio.com:8443 o la IP de tu servidor con ese puerto).
Ve a Herramientas y ajustes (en el menú de la izquierda).
En la sección Servidor, haz clic en Servicios.
Busca el servicio MySQL o MariaDB. Debe aparecer con un estado “En ejecución” (verde).

[WARNING] Si ves el estado “Detenido” o “Error”, haz clic en el botón Iniciar o Reiniciar. A veces, un simple reinicio soluciona el error de conexión.

### Si no puedes acceder a Plesk, usa SSH:

Si tienes acceso SSH al servidor, ejecuta:

systemctl status mysql

O si usas MariaDB:

systemctl status mariadb

Si el servicio está inactivo, inícialo con:

systemctl start mysql

Y habilítalo para que arranque automáticamente:

systemctl enable mysql

[TIP] Muchas veces, después de una actualización del sistema, el servicio MySQL se detiene. Reiniciarlo suele ser la solución más rápida.

Paso 2: Revisa las credenciales en el archivo wp-config.php

WordPress guarda los datos de conexión a la base de datos en el archivo wp-config.php, ubicado en la raíz de tu sitio. Si las credenciales son incorrectas, aparece el error.

### Cómo acceder al archivo wp-config.php desde Plesk:

En Plesk, ve a Sitios web y dominios.
Busca tu dominio y haz clic en Administrar archivos (icono de carpeta).
Navega hasta la carpeta raíz de tu sitio (normalmente httpdocs o public_html).
Busca el archivo wp-config.php. Si no lo ves, activa la opción Mostrar archivos ocultos.
Haz clic derecho sobre él y selecciona Editar.

### Verifica estas líneas:

Dentro del archivo, busca algo como esto:

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

DB_NAME: debe coincidir con el nombre de la base de datos que creaste en Plesk.
DB_USER: el usuario asociado a esa base de datos.
DB_PASSWORD: la contraseña correcta (cuidado con mayúsculas, minúsculas y caracteres especiales).
DB_HOST: normalmente es localhost, pero a veces puede ser una dirección IP o un socket.

[INFO] Si no recuerdas la contraseña, puedes cambiarla desde Plesk: ve a Bases de datos, selecciona la base de datos, y en la pestaña Usuarios podrás editar la contraseña. Luego actualiza wp-config.php con la nueva.

### Si has cambiado la contraseña recientemente:

Si modificaste la contraseña de la base de datos desde Plesk, asegúrate de actualizarla también en wp-config.php. Es un error muy común olvidar este paso.

Paso 3: Verifica que la base de datos y el usuario existan en Plesk

A veces, sin darte cuenta, puedes haber eliminado la base de datos o el usuario. O un proceso automático de limpieza los borró.

### Cómo comprobarlo en Plesk:

En Sitios web y dominios, haz clic en Bases de datos.
Busca la base de datos que usa tu WordPress (debe tener el mismo nombre que en DB_NAME).
Si no aparece, deberás crearla de nuevo. Pero antes, haz una copia de seguridad de los archivos de WordPress (al menos de wp-content/uploads y el tema).

[WARNING] Si la base de datos no existe, perderás todo tu contenido a menos que tengas un respaldo. Siempre es recomendable tener copias de seguridad automáticas.

### Si la base de datos existe pero el usuario no:

Dentro de la misma sección Bases de datos, haz clic en el nombre de la base.
Ve a la pestaña Usuarios.
Verifica que el usuario que aparece en wp-config.php esté listado y tenga todos los privilegios (normalmente Todos).
Si falta, añádelo con la opción Añadir usuario.

Paso 4: Comprueba el host de la base de datos (DB_HOST)

Aunque la mayoría de los servidores usan localhost, algunos entornos con Plesk pueden requerir un host específico, como una dirección IP o un socket.

### Prueba diferentes valores para DB_HOST:

En wp-config.php, cambia temporalmente la línea:

define('DB_HOST', 'localhost');

Por alguna de estas opciones:

127.0.0.1 (la dirección IP local).
El nombre del servidor MySQL (p.ej., mysql.tudominio.com).
Un socket como /var/run/mysqld/mysqld.sock (consulta con tu proveedor de hosting).

[TIP] Si tu sitio está en un hosting compartido con Plesk, el host suele ser localhost. Pero si usas un servidor dedicado o VPS, puede variar.

### Cómo obtener el host correcto:

Pregunta a tu proveedor de hosting.
O revisa la configuración de otras bases de datos en Plesk (ve a Bases de datos y selecciona una; a veces muestra el servidor).
También puedes ejecutar el comando mysqladmin -u root -p variables | grep host desde SSH (si tienes acceso).

Paso 5: Revisa los permisos de la base de datos

A veces el usuario tiene acceso, pero no los permisos suficientes para leer o escribir.

### Cómo ajustar permisos desde Plesk:

Ve a Bases de datos y selecciona tu base de datos.
En la pestaña Usuarios, haz clic en el nombre del usuario.
Asegúrate de que tenga marcados Todos los privilegios (o al menos SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).

[WARNING] Si solo ves privilegios básicos, WordPress puede fallar al intentar actualizar plugins o temas.

### Si no tienes acceso a Plesk, desde MySQL:

GRANT ALL PRIVILEGES ON nombre_base.* TO 'usuario'@'localhost';
FLUSH PRIVILEGES;

Paso 6: Verifica el espacio en disco y la memoria del servidor

Un disco lleno o falta de memoria RAM puede hacer que MySQL se niegue a aceptar conexiones.

### Cómo comprobarlo en Plesk:

Ve a Herramientas y ajustes > Información del servidor.
Busca Uso del disco y Uso de memoria.
Si el disco está al 100%, libera espacio eliminando archivos temporales, logs o backups antiguos.

[INFO] También puedes usar SSH: df -h para ver el espacio en disco y free -h para la memoria.

Paso 7: Repara la base de datos desde Plesk

Si la base de datos está corrupta, WordPress no podrá conectarse correctamente.

### Cómo repararla:

En Bases de datos, selecciona tu base de datos.
Haz clic en Reparar base de datos (icono de llave inglesa).
Espera a que termine el proceso. Si el error persiste, intenta Optimizar también.

[WARNING] La reparación puede fallar si la corrupción es grave. En ese caso, necesitarás restaurar desde una copia de seguridad.

Paso 8: Verifica la compatibilidad de PHP y MySQL

Después de actualizar PHP o MySQL, puede haber incompatibilidades. WordPress requiere versiones específicas.

### Cómo comprobarlo en Plesk:

Ve a Sitios web y dominios > Configuración de PHP (junto a tu dominio).
Asegúrate de que la versión de PHP sea compatible con tu versión de WordPress (WordPress 6.x requiere PHP 7.4 o superior).
En Herramientas y ajustes > Configuración del servidor > Versión de MySQL, verifica que sea 5.6 o superior.

[TIP] Si cambiaste la versión de PHP recientemente, vuelve a la anterior para descartar problemas.

Paso 9: Comprueba el firewall y las reglas de conexión

Algunos servidores tienen firewalls que bloquean conexiones a MySQL desde ciertas IPs.

### En Plesk:

Ve a Herramientas y ajustes > Firewall.
Revisa las reglas de entrada/salida. Asegúrate de que el puerto 3306 (MySQL) esté permitido para localhost o tu IP.

[WARNING] Si tu sitio usa una IP externa para la base de datos, el firewall debe permitir la conexión desde el servidor web.

### Desde SSH:

iptables -L -n | grep 3306

Si ves reglas restrictivas, añade una excepción:

iptables -A INPUT -p tcp --dport 3306 -j ACCEPT

Paso 10: Revisa los logs de error de MySQL

Los logs pueden darte pistas precisas sobre qué está fallando.

### Cómo acceder a los logs desde Plesk:

Ve a Herramientas y ajustes > Registros.
Busca el archivo de log de MySQL (normalmente /var/log/mysql/error.log).
Descárgalo o visualízalo. Busca líneas con palabras como error, connection, access denied.

[INFO] Si no ves logs, desde SSH ejecuta: tail -f /var/log/mysql/error.log mientras intentas acceder a tu sitio.

Preguntas frecuentes (FAQ)

### ¿Qué hago si después de todo sigue el error?

Prueba a restaurar una copia de seguridad reciente de la base de datos y los archivos de WordPress. Si no tienes, contacta con tu proveedor de hosting.

### ¿Puedo usar Syspanel (HestiaCP) en lugar de Plesk?

Si tu servidor usa Syspanel (el nombre que damos a HestiaCP), el proceso es similar, pero el acceso al panel es a través del puerto 2106 (ejemplo: https://tudominio.com:2106). Allí también encontrarás secciones para bases de datos y archivos.

### ¿El error puede deberse a un plugin o tema?

Rara vez, pero si el error aparece después de instalar un plugin, desactívalo renombrando la carpeta wp-content/plugins desde el administrador de archivos de Plesk.

### ¿Cómo evito este error en el futuro?

Realiza copias de seguridad automáticas (Plesk tiene una herramienta para ello).
No cambies contraseñas sin actualizar wp-config.php.
Mantén actualizados WordPress, plugins y temas.
Supervisa el espacio en disco y la memoria del servidor.

Conclusión

El error conexión base datos WordPress puede ser alarmante, pero como has visto, la mayoría de las soluciones son simples y no requieren conocimientos avanzados. Siguiendo estos pasos, podrás diagnosticar y resolver el problema en la mayoría de los casos.

Recuerda que Plesk te ofrece herramientas visuales para gestionar bases de datos, usuarios y servicios, lo que facilita mucho la tarea. Si después de todo el error persiste, no dudes en contactar con el soporte técnico de tu hosting, proporcionándoles los pasos que ya has seguido.

Espero que este artículo te haya sido de ayuda. ¡Tu sitio web volverá a estar online en poco tiempo!