Error establishing database connection WordPress | Solución

¿Qué significa “Error establishing a database connection”?

Este es, sin duda, uno de los mensajes de error más temidos por cualquier persona que tenga una web en WordPress. Si estás leyendo esto, probablemente ya lo has visto en tu pantalla: un texto blanco sobre fondo azul o gris que dice literalmente “Error establishing a database connection”.

Pero, ¿qué significa realmente? Vamos a desglosarlo de forma sencilla.

WordPress es un gestor de contenidos que necesita dos cosas para funcionar: los archivos (el código, las plantillas, los plugins) y una base de datos (donde se guardan tus artículos, páginas, comentarios y ajustes). La base de datos es como el cerebro de tu web.

Cuando tu web muestra el wordpress error conexión, significa que WordPress ha intentado hablar con la base de datos y no ha recibido respuesta. Es como si intentaras llamar a un amigo y su teléfono estuviera apagado. El resultado es que la web se queda bloqueada y no muestra nada.

Lo bueno es que, en la gran mayoría de los casos, este error tiene una solución sencilla que puedes aplicar tú mismo, incluso sin ser un experto en informática. En esta guía, te voy a explicar paso a paso cómo solucionar el error establishing database en los tres paneles de control más comunes: cPanel, Plesk y DirectAdmin.

Antes de empezar: respira y haz una copia de seguridad

[WARNING]: Aunque los pasos que voy a darte son seguros, siempre es recomendable hacer una copia de seguridad de tus archivos y de tu base de datos antes de modificar nada. Si algo sale mal, podrás restaurar tu web en minutos. Pregunta a tu proveedor de hosting cómo hacerlo o busca la opción en tu panel de control.

Ahora sí, vamos a ello. Sigue estos pasos en orden, ya que van de lo más simple a lo más complejo.

Paso 1: Comprueba si el problema es generalizado (y no solo tuyo)

A veces, el wordpress error conexión no es culpa de tu configuración, sino de un problema en el servidor de tu hosting. Es como si el edificio donde vive tu web se quedara sin luz.

Para comprobarlo, intenta acceder a tu panel de control (cPanel, Plesk o DirectAdmin). Si tampoco puedes entrar, o si la página de tu web tarda mucho en cargar, es muy probable que el problema sea del servidor.

En ese caso, contacta con tu proveedor de hosting. Ellos te dirán si hay una caída generalizada o una incidencia. A menudo, este error se soluciona solo cuando ellos reinician los servicios de bases de datos.

[TIP]: Muchos hostings tienen un estado del servicio en su web. Antes de llamar, mira si hay algún aviso.

Paso 2: Revisa tus datos de acceso a la base de datos (el error más común)

La causa más frecuente de este error es que los datos de conexión a la base de datos en tu archivo de configuración sean incorrectos. Es como si tuvieras la llave equivocada para abrir la puerta de tu casa.

WordPress guarda estos datos en un archivo llamado wp-config.php. Es el archivo más importante de configuración de tu web.

### Cómo revisar el `wp-config.php` en cPanel

Accede a tu cPanel.
Busca la sección Archivos y haz clic en Administrador de archivos.
Navega hasta la carpeta donde está instalado tu WordPress (normalmente public_html).
Busca el archivo wp-config.php. Si no lo ves, activa la opción "Mostrar archivos ocultos" en la esquina superior derecha.
Haz clic derecho sobre el archivo y selecciona Editar.
Busca las siguientes líneas (normalmente están al principio del archivo):

define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'nombre_de_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

### Cómo revisar el `wp-config.php` en Plesk

Accede a tu Plesk.
Ve a Sitios web y dominios.
Busca tu dominio y haz clic en Administrador de archivos.
Navega hasta la carpeta httpdocs (o la carpeta raíz de tu web).
Busca el archivo wp-config.php y haz clic en el icono del lápiz para Editar.
Revisa las mismas líneas mencionadas arriba.

### Cómo revisar el `wp-config.php` en DirectAdmin

Accede a tu DirectAdmin.
Busca la sección Administrador de archivos.
Entra en la carpeta domains y luego en la carpeta de tu dominio. Ahí encontrarás la carpeta public_html.
Entra en public_html y busca wp-config.php.
Haz clic derecho y selecciona Editar.

### ¿Qué debo buscar y corregir?

Debes asegurarte de que estos datos coinciden exactamente con los de tu base de datos. Para ello:

Ve a la sección Bases de datos MySQL en tu panel de control (el nombre puede variar ligeramente).
Comprueba que el nombre de la base de datos, el usuario y la contraseña son correctos.
El DB_HOST suele ser localhost, pero a veces es algo como mysql.tudominio.com o localhost:3306. Si no estás seguro, contacta con tu hosting.

[TIP]: Si cambiaste la contraseña de la base de datos recientemente, este es el primer lugar donde debes mirar. Es muy fácil olvidarse de actualizar el wp-config.php.

[WARNING]: No modifiques nada más en este archivo si no sabes lo que haces. Un error al editarlo puede romper tu web por completo.

Paso 3: Soluciona el error establishing database reparando la base de datos

A veces, la base de datos puede estar "dañada" o tener tablas corruptas. WordPress tiene una función oculta para intentar repararlas.

Abre tu archivo wp-config.php como te he explicado antes.
Busca la línea que dice:

define('WP_DEBUG', false);

Justo después de esa línea, añade esta otra:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ahora, ve a tu navegador y escribe esta dirección: tudominio.com/wp-admin/maint/repair.php
Haz clic en el botón Reparar base de datos (Repair Database).
Espera a que termine. Si hay errores, te los mostrará.
Cuando termine, borra la línea que añadiste (define('WP_ALLOW_REPAIR', true);) y guarda el archivo de nuevo. No la dejes ahí, ya que es un riesgo de seguridad.

Este proceso puede solucionar el wordpress database error si el problema es de tablas corruptas.

Paso 4: Comprueba que el servidor de bases de datos (MySQL/MariaDB) esté funcionando

Este paso es un poco más técnico, pero no te preocupes, lo explicaré fácil. A veces, el servicio de bases de datos del servidor se detiene o se bloquea.

### En cPanel

Accede a tu cPanel.
Busca la sección Métricas o Información del sistema. A veces hay un icono llamado "Estado del servidor".
Si tienes acceso a WHM (el panel de administración del servidor), podrás ver el estado de los servicios. Si no, este paso depende de tu proveedor.
Si ves que MySQL o MariaDB está "detenido" o "caído", intenta reiniciarlo. Normalmente hay un botón para hacerlo.

### En Plesk

Accede a Plesk.
Ve a Herramientas y configuración.
Busca la sección Servidor y haz clic en Servicios.
Busca el servicio de MySQL o MariaDB. Si está apagado, el botón de encendido estará en gris. Haz clic en él para iniciarlo.

### En DirectAdmin

Accede a DirectAdmin como administrador (si tienes permisos).
Ve a Administración del sistema y luego a Servicios del sistema.
Busca MySQL o MariaDB y comprueba que está en verde (funcionando). Si está en rojo, haz clic para iniciarlo.

[INFO]: En muchos hostings compartidos, no tendrás acceso para reiniciar los servicios. En ese caso, este paso es para que sepas que el problema puede ser del servidor y debes contactar con tu proveedor.

Paso 5: Optimiza y verifica el uso de recursos de la base de datos

Un problema muy común es que la base de datos esté sobrecargada. Si tu web tiene mucho tráfico o si algún plugin está haciendo consultas demasiado pesadas, el servidor de bases de datos puede bloquearse y devolver el error establishing database.

### ¿Cómo lo soluciono?

Desactiva plugins: Si puedes acceder al panel de administración de WordPress (tudominio.com/wp-admin), ve a Plugins y desactiva todos. Si el error desaparece, reactívalos uno a uno para encontrar al culpable.
Usa un plugin de caché: Un buen plugin de caché (como W3 Total Cache o WP Super Cache) reduce la carga en la base de datos, ya que genera páginas estáticas.
Revisa el límite de memoria: A veces, aumentar el límite de memoria de WordPress ayuda. Puedes añadir esta línea a tu wp-config.php:

define('WP_MEMORY_LIMIT', '256M');

Contacta con tu hosting: Si tu base de datos está usando demasiados recursos, es posible que necesites un plan superior o que ellos te ayuden a optimizarla.

Paso 6: Revisa los permisos de la base de datos

Este es un paso menos común, pero puede ser la causa si has creado una nueva base de datos o un nuevo usuario recientemente.

Ve a la sección Bases de datos MySQL en tu panel de control.
Busca la base de datos que usa tu WordPress.
Comprueba que el usuario que has definido en el wp-config.php está asociado a esa base de datos.
Asegúrate de que el usuario tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.). Normalmente hay una casilla para marcar "TODOS LOS PRIVILEGIOS".

Paso 7: Verifica el archivo `wp-config.php` en busca de espacios o caracteres extraños

A veces, al editar el archivo wp-config.php con un editor de texto como el Bloc de notas, se añaden espacios o caracteres invisibles al principio o al final del archivo. Esto puede romper la conexión con la base de datos.

Abre el archivo wp-config.php con un editor de código (como Notepad++ o Visual Studio Code) o con el editor de tu panel de control.
Asegúrate de que no hay espacios en blanco ni líneas vacías antes de la línea <?php al principio del archivo.
También asegúrate de que no hay nada después de la línea de cierre ?> (si es que existe). Muchos expertos recomiendan eliminar esa línea de cierre para evitar problemas.

Paso 8: Comprueba la conexión con la base de datos usando SSH (nivel avanzado)

Si has llegado hasta aquí y el wordpress error conexión persiste, podemos hacer una prueba más directa. Esto requiere acceso SSH a tu servidor, algo que no todos los hostings ofrecen en planes básicos.

Conéctate a tu servidor por SSH.
Ejecuta este comando para ver si la base de datos responde:

mysql -u tu_usuario -p -h localhost -e "SHOW DATABASES;"

Te pedirá tu contraseña. Si te muestra una lista de bases de datos, la conexión es correcta y el problema está en WordPress. Si te da un error, el problema es del servidor.

[INFO]: Si no sabes qué es SSH, ignora este paso. No es imprescindible para la mayoría de los casos.

Paso 9: Restaura tu web desde una copia de seguridad

Si nada de lo anterior funciona, la solución más rápida y segura es restaurar tu web desde una copia de seguridad reciente. Esto te devolverá a un estado en el que la web funcionaba correctamente.

Accede a tu panel de control y busca la sección Copias de seguridad (el nombre puede variar).
Elige una copia de seguridad anterior al error.
Restaura tanto los archivos como la base de datos.

[WARNING]: Ten en cuenta que perderás todos los cambios que hayas hecho desde esa copia de seguridad. Es una solución de último recurso.

Preguntas frecuentes (FAQ) sobre el error de conexión a la base de datos

### ¿Por qué mi WordPress tiene este error si no he tocado nada?

Puede ser por muchas razones: un fallo del servidor, un ataque de fuerza bruta, un plugin que ha causado un conflicto, o incluso un cambio en la configuración del hosting que no te han comunicado.

### ¿Este error puede dañar mis archivos o mi contenido?

No, el error de conexión a la base de datos no daña tus archivos ni tu contenido. Tu base de datos sigue ahí, solo que WordPress no puede acceder a ella. Una vez solucionado el problema de conexión, todo volverá a la normalidad.

### ¿Cuánto tiempo se tarda en solucionar?

Depende de la causa. Si es un problema de contraseña, lo solucionas en 5 minutos. Si es un problema del servidor, puede tardar unas horas en función de tu proveedor.

### ¿Puedo evitar que esto vuelva a pasar?

Puedes reducir el riesgo haciendo copias de seguridad periódicas, manteniendo WordPress y los plugins actualizados, y usando un buen plugin de caché para reducir la carga en la base de datos.

### ¿Qué es el `DB_HOST` y por qué a veces no es `localhost`?

El DB_HOST es la dirección del servidor donde está alojada la base de datos. En la mayoría de los hostings compartidos es localhost, pero en algunos casos (como cuando la base de datos está en un servidor separado), puede ser una dirección IP o un nombre de dominio.

Conclusión: No pierdas la calma, es un error solucionable

El error establishing database en WordPress puede ser frustrante, pero como has visto, en la mayoría de los casos tiene una solución clara y sencilla. Hemos repasado los pasos más comunes: desde comprobar los datos de conexión en el wp-config.php, pasando por reparar la base de datos, hasta verificar el estado de los servicios en cPanel, Plesk y DirectAdmin.

Recuerda siempre empezar por lo más simple (revisar la contraseña) y avanzar hacia lo más complejo (reparar la base de datos o contactar con tu hosting). Y, sobre todo, no olvides hacer copias de seguridad periódicas. Si este artículo te ha sido útil, compártelo con otros que puedan estar pasando por el mismo problema. ¡Tu web volverá a estar en línea en poco tiempo!