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

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

Uno de los errores más temidos por los administradores de sitios web basados en este CMS es el temido mensaje de 'Error al establecer una conexión con la base de datos'. Este problema impide por completo que tanto los visitantes como tú puedan acceder al contenido de la página o al panel de administración (wp-admin).

Afortunadamente, este fallo suele tener solución si se identifican correctamente sus causas y se siguen los pasos adecuados para restablecer la comunicación entre WordPress y MySQL o MariaDB.

¿Cuáles son las Causas Principales de este Error?

• Credenciales incorrectas en el archivo wp-config.php (nombre de usuario, contraseña o nombre de la base de datos).
• Servidor de la base de datos (MySQL/MariaDB) caído o fuera de servicio.
• Tablas de la base de datos corruptas debido a un apagado inesperado o un plugin defectuoso.
• Alojamiento web (Hosting) con problemas de recursos o suspensión de cuenta.

Método 1: Verificar y Corregir los Datos en el Archivo wp-config.php

El primer paso y el más común es comprobar que los datos de acceso a tu base de datos sean correctos. Sigue estos pasos:

1. Accede a tu panel de control de hosting (cPanel o similar) y abre el Administrador de Archivos, o conéctate mediante un cliente FTP.
2. Busca la carpeta raíz de tu instalación de WordPress y localiza el archivo wp-config.php.
3. Haz clic derecho sobre el archivo y selecciona editar.
4. Revisa las siguientes constantes y asegúrate de que coincidan exactamente con las de tu base de datos:

define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_tu_bd');
define('DB_PASSWORD', 'tu_contrasena');
define('DB_HOST', 'localhost');

Si has cambiado recientemente la contraseña de tu base de datos en el cPanel, debes actualizarla también en este archivo.

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

Si las credenciales son correctas pero el problema persiste, es probable que alguna tabla se haya corrompido. WordPress cuenta con una herramienta interna para reparar esto:

1. Vuelve a abrir el archivo wp-config.php mencionado en el método anterior.
2. Añade la siguiente línea de código justo antes de la frase '¡Eso es todo, deja de editar!':
   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 dirección (reemplaza tudominio.com por tu URL real):
   https://tudominio.com/wp-admin/maint/repair.php
5. Haz clic en el botón Reparar base de datos (o Reparar y optimizar base de datos).
6. Una vez finalizado el proceso, es fundamental que elimines la línea de código que añadiste al archivo wp-config.php por razones de seguridad.

Método 3: Comprobar el Estado del Servidor MySQL

Si tu sitio está alojado en un servidor VPS o dedicado, es posible que el servicio de base de datos se haya detenido. Puedes verificarlo y reiniciarlo mediante la terminal SSH con el siguiente comando:

sudo systemctl status mysql

Si aparece como detenido, reinicia el servicio ejecutando:

sudo systemctl restart mysql

Si utilizas un hosting compartido y ninguna de las soluciones anteriores funciona, te recomendamos ponerte en contacto con el soporte técnico de tu proveedor para verificar si el servidor MySQL está experimentando caídas o si has superado el límite de recursos de tu cuenta.