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

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 temido mensaje "Error al establecer una conexión con la base de datos" en WordPress. Cuando este error aparece, tanto la parte frontal de tu sitio como el panel de administración (wp-admin) quedan inaccesibles para los visitantes.

Este fallo indica que WordPress no puede comunicarse con la base de datos MySQL o MariaDB, ya sea porque las credenciales son incorrectas, el servidor de la base de datos no responde o los archivos de configuración están dañados.

Causas Principales del Error

Antes de aplicar cualquier solución, es importante entender por qué se produce este fallo:

• Credenciales incorrectas en el archivo wp-config.php (nombre de usuario, contraseña o nombre de la base de datos).
• El servidor de la base de datos (MySQL/MariaDB) está caído o no responde debido a una sobrecarga en el hosting.
• Tablas de la base de datos corruptas o dañadas.
• Permisos de usuario mal configurados en el servidor de la base de datos.

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

El paso más común y efectivo es revisar que los datos de acceso en el archivo de configuración principal sean correctos.

1. Conéctate a tu servidor mediante un cliente FTP o el Administrador de Archivos de tu panel de hosting (cPanel o Plesk).
2. Busca la carpeta raíz de tu instalación de WordPress y localiza el archivo wp-config.php.
3. Descarga una copia de seguridad del archivo y luego ábrelo con un editor de código.
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_base_de_datos' );
define( 'DB_USER', 'usuario_de_la_base_de_datos' );
define( 'DB_PASSWORD', 'contraseña_correcta' );
define( 'DB_HOST', 'localhost' );
5. Guarda los cambios y sube el archivo nuevamente al servidor. Actualiza tu sitio web para comprobar si el error ha desaparecido.

Método 2: Comprobar el Estado del Servidor de la Base de Datos

Si las credenciales en wp-config.php son correctas, el problema podría estar en el propio servidor MySQL/MariaDB de tu proveedor de hosting.

1. Si tienes acceso a cPanel, busca la sección de bases de datos y haz clic en phpMyAdmin.
2. Intenta iniciar sesión en phpMyAdmin utilizando las mismas credenciales que encontraste en tu archivo wp-config.php.
3. Si puedes entrar a phpMyAdmin con éxito, significa que tu base de datos funciona y el problema es específico de WordPress.
4. Si no puedes iniciar sesión o recibes un error de conexión en phpMyAdmin, debes contactar de inmediato al soporte técnico de tu empresa de alojamiento web para que reinicien el servicio de MySQL.

Método 3: Reparar Tablas Corruptas en la Base de Datos

Si tu base de datos recibe mucho tráfico o ha sufrido cierres inesperados, algunas tablas pueden haberse corrompido.

1. Accede a phpMyAdmin desde tu panel de control de hosting.
2. Selecciona tu base de datos en el menú lateral izquierdo.
3. Desplázate hasta el final de la lista de tablas y haz clic en la opción Marcar todas.
4. En el menú desplegable junto a la selección, elige Reparar la tabla (Repair table).
5. Si phpMyAdmin no muestra esa opción directamente (común en versiones recientes con MariaDB), puedes añadir esta línea al archivo wp-config.php temporalmente:
   define( 'WP_ALLOW_REPAIR', true );
6. Visita la siguiente URL en tu navegador: https://tu-sitio-web.com/wp-admin/maint/repair.php
7. Sigue las instrucciones en pantalla para reparar y optimizar la base de datos de manera automática. No olvides eliminar la línea de código del archivo wp-config.php una vez finalizado el proceso por razones de seguridad.