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 portada de tu sitio web como el panel de administración (wp-admin) quedan completamente inaccesibles para los visitantes.

Este inconveniente significa que WordPress no puede comunicarse con la base de datos MySQL o MariaDB donde se almacena todo tu contenido, configuraciones y datos de usuario. Afortunadamente, con los conocimientos técnicos adecuados, este fallo se puede resolver en pocos minutos.

Principales Causas del Error

• Credenciales incorrectas en el archivo de configuración wp-config.php.
• 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 plugins defectuosos.
• Permisos de usuario incorrectos en el servidor de la base de datos.

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

La causa más común de este error es una discrepancia en las credenciales de acceso a la base de datos. Sigue estos pasos para verificar tu archivo de configuración:

1. Conéctate a tu servidor web utilizando un cliente FTP (como FileZilla) o el Administrador de Archivos de tu proveedor de hosting.
2. Busca y abre el archivo wp-config.php ubicado en el directorio raíz de tu instalación de WordPress.
3. Localiza las siguientes líneas de código y asegúrate de que coincidan exactamente con los datos de tu base de datos actual:

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');

Si has cambiado recientemente la contraseña de tu base de datos en el cPanel, deberás actualizarla aquí mismo. Guarda los cambios y recarga tu sitio web.

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

Si las credenciales son correctas, es muy probable que algunas tablas de tu base de datos se hayan corrompido. WordPress cuenta con una función nativa oculta para reparar la base de datos automáticamente.

1. Abre nuevamente tu archivo wp-config.php mediante FTP o Administrador de Archivos.
2. Agrega la siguiente línea de código justo antes de la frase ¡Eso es todo, deja de editar! Feliz blogging:

define('WP_ALLOW_REPAIR', true);

1. Guarda los cambios en el archivo y sube la versión actualizada al servidor.
2. Abre tu navegador web y accede a la siguiente URL (reemplaza tudominio.com por el tuyo): https://tudominio.com/wp-admin/maint/repair.php
3. Haz clic en el botón Reparar base de datos o Reparar y optimizar base de datos.
4. Una vez finalizado el proceso, recuerda eliminar la línea de código que agregaste en el archivo wp-config.php por razones de seguridad.

Método 3: Comprobar el Estado del Servidor MySQL

Si utilizas un servidor VPS o dedicado (como DigitalOcean, AWS o un servidor propio), es posible que el servicio de MySQL o MariaDB se haya detenido. Para solucionarlo, conéctate mediante SSH y ejecuta los siguientes comandos:

sudo systemctl status mysql

Si el servicio está detenido, puedes reiniciarlo ejecutando:

sudo systemctl restart mysql

Si usas un hosting compartido, te recomendamos contactar inmediatamente al soporte técnico de tu proveedor para verificar si el servidor SQL está experimentando fallas globales.