Error de conexión a base de datos WordPress | Solución 2024

¡Hola! Si estás leyendo esto, es muy probable que hayas visto el temido mensaje "Error establishing a database connection" en tu sitio WordPress. No te preocupes, respira hondo. Este es uno de los errores más comunes, pero también uno de los más fáciles de solucionar si sigues los pasos adecuados.

En esta guía extensa y súper didáctica, vamos a desglosar, paso a paso, cómo solucionar el error conexión base de datos wordpress en los tres paneles de control más utilizados del mundo del hosting: cPanel, Plesk y DirectAdmin. También mencionaremos alternativas como Syspanel (antes conocido como HestiaCP) para que tengas el panorama completo.

Vamos a ir de lo más simple a lo más complejo. No necesitas ser un experto en informática; solo necesitas calma y seguir esta hoja de ruta.

¿Qué significa exactamente "Error establishing a database connection"?

Antes de lanzarnos a arreglar nada, es crucial entender qué está pasando. WordPress es un software que guarda todo su contenido (artículos, páginas, configuraciones, usuarios) en una base de datos MySQL o MariaDB.

Cuando visitas tu web, WordPress intenta "hablar" con esa base de datos para traer la información y mostrártela. Si por cualquier motivo no puede conectarse, te muestra ese mensaje de error. Es como si intentaras entrar a tu casa, pero la llave no gira en la cerradura.

Las causas suelen ser cuatro:

Datos de acceso incorrectos en el archivo de configuración (wp-config.php).
El servidor de base de datos está caído o sobrecargado.
La base de datos o el usuario han sido eliminados o corruptos.
Problemas con la IP del servidor de base de datos (especialmente en hosts con MySQL remoto).

Vamos a atacar cada una de estas causas.

Paso 1: La Revisión Rápida (Antes de Tocar Nada)

A veces, la solución es más simple de lo que crees. Realiza estas comprobaciones rápidas primero.

¿Es un problema general o solo tuyo?

A veces el problema no es tu web, sino tu conexión a internet o el servidor del hosting. Para descartarlo:

Abre una ventana de incógnito en tu navegador (Chrome, Firefox, etc.).
Visita tu sitio web. Si el error persiste, el problema es del servidor.
Si tienes acceso a otro dispositivo (móvil con datos, otra computadora), pruébalo también.

¿El servidor de tu hosting está caído?

Muchos proveedores de hosting tienen un "Estado del Servicio" en su web. Entra y verifica si hay algún incidente reportado. Si lo hay, solo te queda esperar. No hay nada que puedas hacer desde tu lado.

Reinicia tu router y tu PC

Suena tonto, pero a veces una IP mal asignada o una caché DNS corrupta en tu equipo puede dar problemas de conexión. Un reinicio rápido nunca viene mal.

Paso 2: La Reina de los Archivos – `wp-config.php`

Este es el archivo que contiene las credenciales de acceso a tu base de datos. Es la primera línea de defensa y donde se encuentra el 80% de los problemas.

¿Cómo acceder al archivo?

Necesitas acceder a los archivos de tu hosting. Tienes dos opciones:

El Administrador de Archivos del Panel: Es la forma más fácil. Entra a tu cPanel, Plesk o DirectAdmin y busca el icono "Administrador de Archivos" (File Manager).
FTP/SFTP: Usa un programa como FileZilla. Conecta usando los datos que te dio tu hosting.

Una vez dentro, navega hasta la carpeta public_html (o httpdocs en Plesk, o domains/tudominio.com/public_html en DirectAdmin). Ahí encontrarás el archivo wp-config.php.

¿Qué buscar y qué corregir?

Abre el archivo con un editor de texto (el Bloc de notas o el editor del propio panel). Busca las líneas que dicen DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.

[WARNING] Haz una copia de seguridad de este archivo antes de modificarlo. Solo por si acaso.

Aquí tienes un ejemplo de cómo se ve:

define( 'DB_NAME', 'tu_usuario_wpdb' );
define( 'DB_USER', 'tu_usuario_wpuser' );
define( 'DB_PASSWORD', 'tu_contraseña_secreta' );
define( 'DB_HOST', 'localhost' );

Ahora, vamos a verificar cada campo:

DB_NAME: Es el nombre exacto de tu base de datos. Si tienes dudas, ve a tu panel de control y a la sección de "Bases de Datos MySQL". Copia y pega el nombre exacto.
DB_USER: Es el nombre de usuario que tiene permisos sobre esa base de datos. Asegúrate de que sea el correcto.
DB_PASSWORD: Este es el más común de los errores. A veces, al cambiar la contraseña en el panel, olvidamos actualizarla aquí. Corrígelo con la contraseña actual.
DB_HOST: Este es un punto clave. Normalmente es localhost, pero en muchos hostings (como WP Engine o Kinsta) es una dirección IP o un nombre de servidor específico (ej. mysql.tudominio.com). Si tu hosting te dio un host específico, úsalo.

[TIP] Si cambiaste la contraseña en tu panel de hosting, asegúrate de que la contraseña en wp-config.php sea exactamente la misma, sin espacios ni caracteres extraños. Una forma de probar es crear un archivo de prueba, pero eso lo veremos más adelante.

Paso 3: El Panel de Control – Verificación de la Base de Datos

Si los datos en wp-config.php parecen correctos, el problema puede estar en el propio servidor de bases de datos o en los permisos del usuario.

En cPanel

Busca la sección "Bases de Datos" y haz clic en "Bases de Datos MySQL".
Verifica que tu base de datos aparezca en la lista.
En la lista de "Usuarios en la base de datos", asegúrate de que tu usuario esté asociado a la base de datos. Si no lo está, agrégalo y dale TODOS LOS PRIVILEGIOS.
Si el usuario no existe, créalo de nuevo y asígnalo a la base de datos.

En Plesk

Ve a "Sitios web y dominios" y selecciona tu dominio.
Busca la sección "Bases de datos" (o "Bases de datos MySQL").
Haz clic en el nombre de tu base de datos para ver los usuarios asociados.
Si el usuario no está, añádelo y otórgale todos los privilegios.

En DirectAdmin

Ve a "Gestión de MySQL" (o "MySQL Management").
Verás una lista de bases de datos y usuarios.
Asegúrate de que el usuario tenga permisos sobre tu base de datos. Si no, edita los permisos y selecciona "Todos los privilegios".

En Syspanel (antes HestiaCP)

[INFO] Si tu hosting usa Syspanel, el acceso al panel se realiza a través del puerto 2106 (ej. https://tudominio.com:2106). La gestión de bases de datos se encuentra en la sección "Base de datos" o "Databases". El proceso es similar: verifica que la base de datos y el usuario existan y que estén vinculados correctamente.

Paso 4: La Prueba Definitiva – Conectando Directamente a MySQL

A veces, el problema no es WordPress, sino que la base de datos no responde. Para probarlo, vamos a intentar conectarnos directamente.

Usando phpMyAdmin

phpMyAdmin es una herramienta web que te permite interactuar con tu base de datos.

Ve a tu panel de control y busca el icono de phpMyAdmin (en cPanel, Plesk, DirectAdmin o Syspanel).
Intenta iniciar sesión con el usuario y contraseña que pusiste en wp-config.php.
Si NO puedes iniciar sesión, el problema son las credenciales. Si puedes iniciar sesión pero WordPress no, entonces el problema es el DB_HOST o un conflicto de permisos.

Creando un archivo de prueba (el "test.php")

Este es un truco de experto para aislar el problema.

En la misma carpeta donde está wp-config.php, crea un archivo nuevo llamado test.php.
Ábrelo con el editor y pega este código:

<?php
$connection = mysqli_connect(DB_HOST, DB_USER, DB_PASSWORD, DB_NAME);

if (!$connection) {
    die("Error de conexión: " . mysqli_connect_error());
} else {
    echo "¡Conexión exitosa a la base de datos!";
}
?>

¡IMPORTANTE! Este código no funciona solo. Debe incluir los datos de wp-config.php. Una forma más simple es usar el siguiente código (que lee los datos del archivo de configuración):

<?php
define('WP_USE_THEMES', false);
require_once('wp-config.php');
$connection = @mysqli_connect(DB_HOST, DB_USER, DB_PASSWORD, DB_NAME);

if (!$connection) {
    die("Error de conexión: " . mysqli_connect_error());
} else {
    echo "¡Conexión exitosa a la base de datos!";
    mysqli_close($connection);
}
?>

Guarda el archivo y visita tudominio.com/test.php.
Si ves "¡Conexión exitosa!", significa que tus credenciales son correctas y el problema es de WordPress (quizás una caché o un plugin). Si ves un error de conexión, el problema es de las credenciales o del servidor MySQL.

[WARNING] BORRA INMEDIATAMENTE el archivo test.php después de la prueba. Dejarlo en el servidor es un riesgo de seguridad enorme.

Paso 5: Soluciones Avanzadas (Cuando Nada de lo Anterior Funciona)

Si has llegado hasta aquí y el error persiste, el problema es más profundo.

Reparar la Base de Datos

WordPress tiene una función de reparación automática integrada.

Añade la siguiente línea a tu archivo wp-config.php, justo después de la línea define('DB_HOST', ...):

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y visita tudominio.com/wp-admin/maint/repair.php.
Haz clic en "Reparar base de datos". Puedes elegir "Reparar y Optimizar" para una limpieza más profunda.
Cuando termine, ELIMINA esa línea de wp-config.php inmediatamente.

Problemas con el Hosting (MySQL caído o sobrecargado)

A veces, el servidor MySQL simplemente se ha caído o está sobrecargado. Esto puede pasar por picos de tráfico o por un ataque.

Contacta con tu proveedor de hosting. Ellos pueden verificar el estado del servidor de bases de datos y reiniciarlo si es necesario.
Pregunta si hay algún límite de conexiones activas. Si tienes muchos plugins que hacen consultas a la base de datos, podrías estar superando el límite.

Restaurar desde una Copia de Seguridad

Si has modificado algo y no puedes revertirlo, o si la base de datos está corrupta sin remedio, la solución más rápida es restaurar una copia de seguridad reciente.

Ve a la sección de "Copias de Seguridad" (Backups) en tu panel de control.
Localiza la copia más reciente de tu base de datos.
Restaura la base de datos. Esto sobrescribirá la actual.

[WARNING] Esta opción borrará cualquier cambio que hayas hecho desde la fecha de la copia de seguridad. Úsala como último recurso.

Preguntas Frecuentes (FAQ)

¿Por qué veo el error de conexión a la base de datos después de cambiar la contraseña de MySQL?

Es la causa más común. Cuando cambias la contraseña en el panel de control, debes actualizar el archivo wp-config.php con la nueva contraseña. Es fácil olvidarlo.

¿Qué es `DB_HOST` y por qué no debería ser siempre `localhost`?

DB_HOST es la dirección del servidor donde se encuentra la base de datos. En la mayoría de los hostings compartidos, es localhost porque la base de datos está en el mismo servidor que tu web. Sin embargo, en hostings más grandes o con arquitectura en la nube, la base de datos puede estar en un servidor separado, y tendrás que usar una dirección IP o un nombre de dominio específico que te proporcionará tu proveedor.

Mi web funciona, pero el panel de administración (wp-admin) no. ¿Por qué?

Esto suele indicar un problema de permisos de archivos o un conflicto con un plugin. A veces, el error de conexión solo afecta a una parte de la web. Prueba a desactivar todos los plugins renombrando la carpeta wp-content/plugins a plugins_backup. Si el panel funciona, reactiva los plugins uno a uno para encontrar al culpable.

¿Qué hago si veo el error en un sitio que no es WordPress?

Este error es específico de WordPress. Si ves un error similar en otro CMS, el proceso de diagnóstico es similar, pero el archivo de configuración tendrá otro nombre.

¿Puedo solucionar esto sin acceso al panel de control de hosting?

Es muy difícil. Necesitas acceso al panel para verificar las bases de datos o al FTP para editar el archivo wp-config.php. Si no tienes acceso, contacta a tu proveedor de hosting lo antes posible.

Resumen y Consejo Final

Hemos recorrido un largo camino, desde lo más simple (verificar la conexión a internet) hasta lo más complejo (reparar la base de datos). La clave está en la paciencia y en seguir los pasos en orden.

Recuerda el flujo de trabajo:

Verifica si el servidor está caído.
Revisa el archivo wp-config.php y corrige las credenciales.
Verifica en el panel que la base de datos y el usuario existen y están vinculados.
Prueba la conexión con un archivo de prueba.
Repara la base de datos o restaura desde un backup.

[TIP] Si no te sientes cómodo editando archivos o usando código, no dudes en contactar al soporte técnico de tu hosting. Para eso están. Describe el error y los pasos que ya has intentado; te lo agradecerán.

Espero que esta guía te haya sido de gran ayuda. Con un poco de suerte, tu sitio web estará funcionando en poco tiempo. ¡Mucho ánimo y a seguir creando contenido!