Arreglar 'Error al conectar con la base de datos' en WordPress

¡Hola! Si estás leyendo esto, es muy probable que hayas intentado entrar a tu sitio web y te hayas encontrado con un mensaje que hiela la sangre: "Error al conectar con la base de datos". No te preocupes, respira hondo. Este es uno de los errores más comunes en WordPress y, en la gran mayoría de los casos, tiene solución rápida y sencilla.

En esta guía extensa y paso a paso, vamos a desglosar todas las causas posibles y, lo más importante, cómo arreglar error conexión WordPress sin necesidad de ser un experto en informática. Vamos a ensuciarnos las manos, pero con cuidado y método.

¿Qué significa exactamente este error?

Antes de lanzarnos a la acción, es fundamental entender qué está pasando. WordPress es un gestor de contenidos que necesita dos cosas para funcionar: un servidor web (donde viven los archivos) y una base de datos (donde se guardan tus artículos, páginas, comentarios y configuraciones).

Cuando ves el mensaje wordpress database error, significa que WordPress no puede encontrar o comunicarse con esa base de datos. Es como si intentaras hacer una llamada telefónica pero la línea estuviera cortada o el número fuera incorrecto. Sin esa conexión, el sitio no puede cargar nada de su contenido.

A veces, verás un mensaje más específico que dice Error establishing a database connection (en inglés) o el famoso error connecting database wordpress. Todas estas frases apuntan al mismo problema.

Primeros pasos: Diagnóstico inicial (no te saltes esto)

Cuando ocurre un error base de datos wordpress, la causa suele estar en uno de estos cuatro lugares:

Los datos de acceso en wp-config.php (el archivo de configuración).
El servidor de base de datos está caído o sobrecargado.
La base de datos está dañada o corrupta.
El servidor se quedó sin espacio en disco o hay problemas de permisos.

Nuestro trabajo es ir descartando estas posibilidades una por una. Vamos a empezar por lo más simple y avanzar hacia lo más complejo.

Paso 1: La Prueba del "Front-End" vs "Back-End"

Primero, intenta acceder a la dirección de administración de tu WordPress. Normalmente es tudominio.com/wp-admin.

Si te sale el error también en wp-admin: El problema es general y afecta a toda la instalación. Sigue con el paso 2.
Si el wp-admin funciona pero el resto del sitio no: Esto es raro, pero puede indicar un problema con un plugin o tema, no con la base de datos en sí. Aún así, sigue los pasos, ya que la solución de los permisos puede ayudar.

Paso 2: El Sospechoso Habitual: El archivo `wp-config.php`

Este es el archivo más importante para esta solución. Contiene las llaves del reino: el nombre de la base de datos, el usuario, la contraseña y el host. Si algo aquí está mal, tienes el error asegurado.

Para revisarlo, necesitas acceder a tu panel de control de hosting o al administrador de archivos (cPanel, Syspanel, Plesk, etc.).

¿Cómo acceder al archivo?

Entra a tu panel de control de hosting. Si usas Syspanel, recuerda que el puerto de acceso es el 2106 (por ejemplo, http://tu-servidor:2106).
Busca la sección "Administrador de Archivos" o "File Manager".
Navega hasta la carpeta donde está instalado WordPress. Si es la raíz, normalmente será public_html o www.
Busca el archivo llamado wp-config.php. No lo confundas con wp-config-sample.php. Ese es solo una plantilla.

¿Qué buscar dentro del archivo?

Abre el archivo con el editor de texto del panel. Busca líneas que se parezcan a estas:

// ** Configuración de la base de datos ** //
define( 'DB_NAME', 'tu_nombre_de_base_de_datos' );
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

Aquí es donde ocurre el 90% de los errores. Verifica que:

DB_NAME: El nombre sea exactamente el mismo que aparece en tu panel de control de hosting, en la sección de "Bases de Datos MySQL".
DB_USER: El usuario sea el correcto y tenga todos los privilegios sobre la base de datos DB_NAME.
DB_PASSWORD: La contraseña sea la correcta. A veces, al cambiar la contraseña en el panel de hosting, olvidamos actualizarla aquí. Si la has cambiado recientemente, este es el culpable.
DB_HOST: Normalmente es localhost, pero algunos proveedores usan una dirección como mysql.tudominio.com o localhost:3306. Si no estás seguro, contacta con tu proveedor de hosting.

[WARNING]: Al editar este archivo, ten muchísimo cuidado. Un solo carácter mal puesto (un punto y coma o una comilla) romperá tu sitio. Si no te sientes seguro, haz una copia de seguridad del archivo antes de tocarlo.

¿Cómo arreglarlo? Si encuentras un dato incorrecto, corrígelo y guarda el archivo. Luego, recarga tu sitio web. Si el error persiste, sigue leyendo.

Paso 3: El Servidor de Base de Datos está Caído

A veces el problema no es tuyo, sino del servidor. Imagina que la base de datos es un motor y el servidor es el coche. Si el motor se ha parado, no puedes ir a ningún lado.

¿Cómo comprobarlo? No puedes "ver" la base de datos directamente, pero sí puedes hacer una prueba sencilla desde el Administrador de Archivos.

Crea un archivo nuevo en la misma carpeta de WordPress. Nómbralo testdb.php.

Edítalo y pega este código (es un script de prueba muy básico):

<?php
$conexion = @mysqli_connect(DB_HOST, DB_USER, DB_PASSWORD, DB_NAME);
if (!$conexion) {
    echo "Error: No se puede conectar al servidor de base de datos.";
    echo "Mensaje de error: " . mysqli_connect_error();
} else {
    echo "Conexión exitosa. El servidor de base de datos está en línea.";
}
?>

Pero espera, este script necesita los datos de wp-config.php. Es más fácil usar una versión que los incluya. Mejor crea un archivo testdb.php con este contenido:

<?php
// Incluimos la configuracion de wordpress para usar sus datos
define('WP_USE_THEMES', false);
require_once(dirname(__FILE__) . '/wp-load.php');

$conexion = @mysqli_connect(DB_HOST, DB_USER, DB_PASSWORD, DB_NAME);
if (!$conexion) {
    echo "Error: No se puede conectar al servidor de base de datos.<br>";
    echo "Mensaje de error: " . mysqli_connect_error();
} else {
    echo "Conexión exitosa. El servidor de base de datos está en línea.";
    mysqli_close($conexion);
}
?>

Guarda el archivo y accede a él desde tu navegador: tudominio.com/testdb.php.

Si ves "Conexión exitosa": Entonces el problema no es el servidor de base de datos. Puedes borrar el archivo testdb.php y pasar al Paso 4. El problema es más específico de WordPress.
Si ves "Error: No se puede conectar": El servidor de base de datos está caído o los datos en wp-config.php son incorrectos. Verifica de nuevo los datos y, si siguen bien, contacta a tu proveedor de hosting. Ellos deben reiniciar el servicio MySQL/MariaDB.

[TIP]: Si el servidor de la base de datos está caído, no hay nada que puedas hacer desde tu lado. Es un problema del hosting. Llama a su soporte y diles que tienes un "Error establishing a database connection".

Paso 4: Reparar la Base de Datos Corrupta

Si la conexión se hace correctamente pero WordPress sigue fallando, es posible que la base de datos esté dañada. Esto puede pasar por cortes de energía, errores del servidor o interrupciones durante una actualización.

WordPress tiene una herramienta de reparación integrada. Aquí te mostramos cómo activarla:

De nuevo, ve a tu Administrador de Archivos y abre el archivo wp-config.php.
Busca la línea que dice define( 'WP_DEBUG', false ); o similar.
Justo antes de esa línea, añade esta nueva línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Ahora, en tu navegador, ve a esta dirección: tudominio.com/wp-admin/maint/repair.php
Verás una pantalla que te ofrece dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en la primera (Reparar).
Espera a que termine el proceso. Te mostrará una tabla con los resultados.
IMPORTANTE: Una vez que hayas terminado, borra la línea que añadiste (define('WP_ALLOW_REPAIR', true);) del archivo wp-config.php. Dejar esta línea activa es un riesgo de seguridad enorme, ya que cualquiera podría acceder a la herramienta de reparación.

[INFO]: Este método es seguro y no borra tus datos. Solo intenta corregir las tablas dañadas de la base de datos.

Paso 5: Espacio en Disco y Permisos de Archivos

A veces, el problema no es la base de datos en sí, sino el entorno donde vive.

A. Espacio en disco lleno

Si tu servidor se queda sin espacio, la base de datos puede fallar al intentar escribir nuevos datos o incluso al leer los existentes. Para comprobarlo:

Ve a tu panel de control de hosting (Syspanel, cPanel, etc.).
Busca la sección "Uso de Disco" o "Estadísticas".
Si ves que el disco está al 90% o más, es hora de limpiar archivos temporales, copias de seguridad antiguas o cachés. También puedes contactar con tu proveedor para aumentar el espacio.

B. Permisos de archivos incorrectos

Los archivos de WordPress deben tener permisos específicos para que el servidor pueda leerlos y ejecutarlos. Si están mal configurados, puede dar problemas.

Los carpetas o directorios deben tener permisos 755 o 750.
Los archivos deben tener permisos 644 o 640.

¿Cómo cambiarlos?

En el Administrador de Archivos, selecciona la carpeta raíz de WordPress (public_html).
Haz clic derecho y busca la opción "Permisos" o "Change Permissions".
Asegúrate de que las carpetas estén en 755 y los archivos en 644. Puedes seleccionar todos y aplicar en lote, pero cuidado de no cambiar los permisos del wp-config.php por error.

Paso 6: El Último Recurso: Desactivar Plugins (Acceso por FTP)

Si nada de lo anterior funciona, es posible que un plugin o tema esté causando un conflicto. Pero, ¿cómo lo desactivas si no puedes entrar al admin?

Puedes hacerlo renombrando la carpeta de los plugins. Esto es un poco más técnico, pero muy efectivo.

Necesitas un cliente FTP como FileZilla, o usar el Administrador de Archivos de tu hosting.
Ve a la carpeta wp-content dentro de tu instalación de WordPress.
Verás una carpeta llamada plugins. Cámbiale el nombre a plugins_desactivados (o algo similar).
Intenta cargar tu sitio web.

Si el error desaparece: El problema era uno de tus plugins. Ahora, crea una nueva carpeta llamada plugins y ve moviendo los plugins de plugins_desactivados a la nueva carpeta uno a uno, recargando el sitio después de cada movimiento para identificar al culpable.
Si el error persiste: El problema no es un plugin. Puedes renombrar la carpeta a plugins de nuevo y seguir con el siguiente paso.

¿Y si es el tema? De manera similar, puedes renombrar la carpeta del tema activo en wp-content/themes. WordPress usará un tema por defecto (como Twenty Twenty-Four) si no encuentra el que buscas.

Resumen rápido de la solución (Checklist)

Aquí tienes una lista de verificación rápida para que no te pierdas:

Revisé los datos en wp-config.php (nombre, usuario, contraseña, host).
Creé un archivo testdb.php para verificar si el servidor de base de datos está en línea.
[ (Opcional) ] Activé la herramienta de reparación de BD en WordPress.
Comprobé el espacio en disco del servidor.
Verifiqué los permisos de archivos y carpetas (755/644).
Desactivé todos los plugins renombrando la carpeta plugins.
Contacté con mi proveedor de hosting si nada funcionó.

Preguntas Frecuentes (FAQ)

P: ¿Perderé mis datos si aplico estas soluciones?

R: No. La mayoría de estas soluciones (revisar wp-config.php, reparar la base de datos, desactivar plugins) no borran tu contenido. La base de datos se repara, no se vacía. Tus artículos y páginas están a salvo.

P: No encuentro el archivo wp-config.php. ¿Dónde está?

R: Debe estar en la carpeta raíz de tu WordPress (normalmente public_html). Si no lo ves, activa la opción "Mostrar archivos ocultos" en tu Administrador de Archivos o cliente FTP.

P: He cambiado la contraseña de la base de datos en mi hosting y ahora tengo el error. ¿Qué hago?

R: Ese es el problema. Debes actualizar la contraseña en el archivo wp-config.php con la nueva que has creado. Es un paso fácil de olvidar.

P: Todos mis archivos y datos parecen correctos, pero el error persiste. ¿Qué más puedo hacer?

R: Ha llegado el momento de contactar con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso a los logs del servidor y pueden ver el error exacto de la base de datos. Diles que tienes el "Error al conectar con la base de datos" y que ya has revisado wp-config.php y la conectividad.

P: ¿Qué es eso de "Syspanel" que mencionas?

R: Es el panel de control de hosting que utilizamos en algunos de nuestros planes. Es una herramienta para gestionar tus archivos, bases de datos y dominios. Puedes acceder a él a través del puerto 2106 (por ejemplo, http://tu-servidor:2106).

Esperamos que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave. Ve paso a paso, sin prisa, y sobre todo, no te saltes la regla de borrar la línea WP_ALLOW_REPAIR después de usarla. Si has llegado hasta aquí y has probado todo, es muy probable que necesites la ayuda de tu hosting, así que no dudes en contactarlos. ¡Buena suerte!