Cómo Solucionar el Error al Establecer una Conexión con la Base de Datos en WordPress Paso a Paso

Introducción al Error de Conexión a la Base de Datos en WordPress

Uno de los problemas más frustrantes a los que se enfrentan los administradores de sitios web es el mensaje Error al establecer una conexión con la base de datos en WordPress. Este fallo significa que tu sitio web no puede comunicarse con la base de datos MySQL o MariaDB donde se almacena todo tu contenido, configuraciones y datos de usuario.

Cuando esto ocurre, tanto la parte frontal de tu web como el panel de administración (wp-admin) quedan inaccesibles. Afortunadamente, este problema tiene solución si se diagnostica correctamente siguiendo los pasos adecuados.

Causas Principales del Error

Las razones más comunes por las que ocurre este fallo en WordPress incluyen:

• Credenciales incorrectas en el archivo wp-config.php (nombre de la base de datos, usuario, contraseña o servidor).
• La base de datos se ha corrompido debido a un apagado inesperado del servidor, un plugin defectuoso o un ataque malicioso.
• El servidor de la base de datos (MySQL/MariaDB) está caído o no responde debido a una sobrecarga o fallo en el proveedor de hosting.
• Archivos del núcleo de WordPress corruptos o dañados.

Método 1: Verificar y Corregir las Credenciales en wp-config.php

La causa número uno de este error son los datos erróneos en el archivo de configuración principal de WordPress. Sigue estos pasos para verificar tus credenciales:

1. Conéctate a tu servidor mediante un cliente FTP (como FileZilla) o utiliza el Administrador de Archivos de tu panel de hosting (cPanel o Plesk).
2. Localiza la raíz de tu instalación de WordPress y busca el archivo llamado wp-config.php.
3. Descarga una copia de seguridad del archivo y luego ábrelo con un editor de código (como Notepad++ o VS Code).
4. Busca las siguientes líneas de código:

define( 'DB_NAME', 'nombre_de_tu_bd' );
define( 'DB_USER', 'usuario_de_tu_bd' );
define( 'DB_PASSWORD', 'contraseña_de_tu_bd' );
define( 'DB_HOST', 'localhost' );

5. Accede a tu panel de control de hosting (ej. cPanel) y entra en Bases de datos MySQL para verificar que el nombre de la base de datos, el usuario y la contraseña coincidan exactamente con los escritos en tu wp-config.php.
6. Si creaste un nuevo usuario o cambiaste la contraseña recientemente, actualiza estos valores en el archivo, guárdalo y súbelo de nuevo al servidor. Comprueba si tu sitio web vuelve a funcionar.

Método 2: Reparar la Base de Datos desde WordPress

Si tus credenciales son correctas pero el problema persiste, es muy probable que las tablas de tu base de datos se hayan corrompido. WordPress cuenta con una función nativa para reparar bases de datos dañadas.

1. Abre nuevamente el archivo wp-config.php mediante FTP o Administrador de Archivos.
2. Añade la siguiente línea de código justo antes de la frase /* ¡Eso es todo, deja de editar! Feliz publicación */:

define( 'WP_ALLOW_REPAIR', true );

3. Guarda los cambios y sube el archivo al servidor.
4. Abre tu navegador web y entra a la siguiente URL (reemplaza tusitio.com por tu dominio real):

https://tusitio.com/wp-admin/maint/repair.php

5. Verás una página con opciones de optimización y reparación. Haz clic en el botón Reparar base de datos (o Reparar y optimizar base de datos).
6. Una vez que el proceso finalice, es de vital importancia que vuelvas a editar tu archivo wp-config.php para eliminar la línea de código que agregaste, ya que dejarla habilitada representa un riesgo de seguridad.

Método 3: Comprobar el Estado del Servidor MySQL/MariaDB

Si tu sitio web está alojado en un servidor VPS o dedicado (o incluso en un hosting compartido con fallos en el servicio), es posible que el motor de la base de datos se haya detenido.

1. Si tienes acceso SSH a tu servidor, conéctate como usuario root o con privilegios de sudo.
2. Ejecuta el siguiente comando para verificar si el servicio MySQL está activo (en sistemas basados en Ubuntu/Debian):

sudo systemctl status mysql

3. Si el servicio aparece detenido o caído, intenta reiniciarlo ejecutando el comando:

sudo systemctl restart mysql

4. Si utilizas un hosting compartido y no tienes acceso al backend del servidor, ponte en contacto de inmediato con el soporte técnico de tu proveedor para preguntar si hay incidencias en el clúster de bases de datos.