Error de conexión a la base de datos en WordPress: causas y soluciones

Si su web muestra el mensaje "Error establishing a database connection" (en las instalaciones en español, "Error al establecer una conexión con la base de datos"), WordPress está funcionando pero no consigue comunicarse con la base de datos donde se guarda su contenido.

Cada página, entrada, producto, pedido, usuario y ajuste de una web WordPress está en esa base de datos. Cuando WordPress no puede llegar a ella, no tiene nada que mostrar, así que todo el sitio suele quedarse en esa única línea de texto. Normalmente también se ve afectado el escritorio de administración.

El mensaje parece grave y, para una web de empresa, lo es: los visitantes no ven nada útil hasta que se soluciona. Sin embargo, en la mayoría de los casos no significa que se hayan borrado sus datos. Suele significar que la base de datos está temporalmente inaccesible o sobrecargada, o que WordPress está usando datos incorrectos para conectarse a ella.

Esta guía explica qué significa el mensaje, cuáles son las causas más comunes, qué puede comprobar sin riesgo y cuándo es mejor pedir soporte técnico.

¿Qué significa realmente este error?

Una web WordPress tiene dos partes principales:

los archivos, como el propio WordPress, los plugins, los temas y las imágenes subidas
la base de datos, que almacena el contenido y la configuración

Cuando alguien abre una página, WordPress lee un archivo de configuración llamado wp-config.php para saber dónde está la base de datos y cómo acceder a ella. Después se conecta al servidor de base de datos y le pide el contenido de la página.

El error aparece cuando esa conexión falla. WordPress no sabe exactamente por qué, así que muestra el mismo mensaje genérico tanto si el servidor de base de datos está caído como si la contraseña es incorrecta o el servidor simplemente está demasiado ocupado para responder.

Por eso el mensaje por sí solo no puede decirle qué ha causado el problema. Le dice dónde está el problema, no en qué consiste.

¿He perdido mi contenido?

Normalmente no.

En la mayoría de los casos los datos siguen ahí. Simplemente, WordPress no puede llegar a ellos en este momento. Cuando se restablece la conexión, la web suele volver a aparecer exactamente como estaba.

Hay excepciones, por ejemplo un servidor averiado, una base de datos eliminada o una corrupción grave. Son menos frecuentes, y son un motivo más para evitar acciones precipitadas, como restaurar una copia de seguridad antigua o reinstalar WordPress antes de conocer la causa.

¿Cuáles son las causas más comunes?

El servidor de base de datos está caído o sobrecargado

En la mayoría de los planes de hosting, la base de datos funciona en un servidor gestionado por el proveedor de hosting. Si ese servidor se está reiniciando, está en mantenimiento o está sobrecargado, WordPress no puede conectarse.

Señales que apuntan en esta dirección:

el error ha aparecido de repente, sin que nadie haya cambiado la web
aparece y desaparece, sobre todo en los momentos de más actividad
otras webs de la misma cuenta de hosting muestran el mismo error
el proveedor de hosting informa de una incidencia o de un mantenimiento

Un pico de tráfico, un bot agresivo, una importación pesada o un plugin que funciona mal también pueden sobrecargar la base de datos, de modo que algunas peticiones fallan y otras no.

Los datos de conexión de wp-config.php son incorrectos

wp-config.php contiene cuatro datos que WordPress necesita para conectarse:

el nombre de la base de datos
el usuario de la base de datos
la contraseña de ese usuario
el host de la base de datos, es decir, la dirección del servidor de base de datos

Si alguno de ellos es incorrecto, la conexión falla. Suele ocurrir:

después de una migración a un nuevo proveedor de hosting o a un nuevo servidor
después de cambiar la contraseña de la base de datos en el panel del hosting
después de que alguien restaurara una copia antigua de wp-config.php
después de que el proveedor de hosting trasladara la base de datos a otro servidor
después de que se eliminara el usuario de la base de datos o perdiera sus permisos

Si el error apareció justo después de uno de estos hechos, esta es la causa más probable.

Las tablas de la base de datos están dañadas

Las tablas de la base de datos pueden corromperse, por ejemplo tras una caída del servidor, un disco lleno o una operación interrumpida. En ese caso, WordPress puede conectarse pero no consigue leer lo que necesita.

A veces la parte pública del sitio muestra el error de conexión mientras que el escritorio muestra otro mensaje que indica que hay que reparar la base de datos.

La cuenta de hosting ha alcanzado un límite

Los planes de hosting suelen tener límites en:

el número de conexiones simultáneas a la base de datos
el espacio en disco, que también usa la base de datos
el tamaño de la base de datos
el uso de CPU o de memoria

Cuando se alcanza un límite, la base de datos puede rechazar conexiones nuevas o dejar de funcionar correctamente. El proveedor de hosting normalmente puede confirmarlo con rapidez.

La cuenta se ha suspendido

Si la cuenta de hosting se ha suspendido, por ejemplo por una factura impagada, un problema con las condiciones de uso o un problema de seguridad, la base de datos puede estar desactivada aunque los archivos sigan en línea. Revise si tiene correos de su proveedor de hosting.

¿Qué debe comprobar primero?

No necesita abrir ningún archivo para recopilar información útil.

Compruebe si el error es constante o intermitente

Recargue la web varias veces durante unos minutos, preferiblemente en una ventana privada o de incógnito.

Si el error aparece siempre, es más probable que se trate de un problema de configuración o de una base de datos completamente caída.
Si aparece y desaparece, es más probable que se trate de sobrecarga o de límites del hosting.

Compruebe si ha cambiado algo

Piense en lo que ocurrió justo antes de que apareciera el error:

¿Se migró la web o se trasladó a un servidor nuevo?
¿Alguien cambió una contraseña en el panel del hosting?
¿Se restauró una copia de seguridad?
¿El proveedor de hosting anunció un mantenimiento?
¿Había en marcha una importación grande, una newsletter o una promoción?
¿Alguien instaló un plugin nuevo?

Una nota como "el error empezó la mañana después de cambiar la contraseña de la base de datos" puede ahorrar mucho tiempo de investigación.

Revise otras webs de la misma cuenta

Si aloja varias webs con el mismo proveedor, ábralas. Si todas muestran el mismo error, es muy probable que el problema esté en el hosting y no dentro de su instalación de WordPress.

Revise el estado y los correos de su proveedor de hosting

Busque:

una página de estado o un aviso de incidencia de su proveedor de hosting
correos sobre mantenimiento, límites o suspensión
avisos sobre el espacio en disco en el panel del hosting

¿Qué puede probar sin riesgo?

Contacte con su proveedor de hosting

Con este error en concreto, el proveedor de hosting suele ser el mejor primer contacto. Normalmente puede confirmar en poco tiempo si:

el servidor de base de datos está funcionando
la base de datos y su usuario siguen existiendo
la cuenta ha alcanzado algún límite
el valor del host de la base de datos que debe usar es correcto
ha habido una incidencia o un mantenimiento

Pregúntele con claridad: "¿Está funcionando el servidor de base de datos de mi cuenta, y siguen siendo los mismos el nombre de la base de datos, el usuario y el host?"

Contacte con quien trabajó por última vez en la web

Si un desarrollador, una agencia o un compañero ha migrado recientemente el sitio, ha cambiado ajustes del hosting o ha restaurado una copia de seguridad, pregúntele qué cambió. Puede que sepa de inmediato qué valor hay que corregir.

Espere unos minutos si el error es intermitente

Si el proveedor de hosting confirma una sobrecarga temporal o un mantenimiento, la web puede volver por sí sola. Aun así, queda una pregunta que conviene responder más adelante: por qué se sobrecargó la base de datos y si podría volver a ocurrir en un momento importante para su negocio.

¿Qué debe evitar?

Cuando la web está caída, es tentador probar varias soluciones rápidamente. Evite:

reinstalar WordPress
restaurar una copia de seguridad antes de conocer la causa, porque puede sobrescribir pedidos, envíos de formularios o contenidos recientes
crear una base de datos nueva y vacía y apuntar WordPress hacia ella, lo que hace que el sitio parezca una instalación nueva
eliminar o volver a crear el usuario de la base de datos sin anotar los datos anteriores
editar wp-config.php sin guardar antes una copia del original
copiar código o ajustes al azar encontrados en foros
ejecutar herramientas de reparación una y otra vez sin entender lo que hacen

Si después de un cambio ve la pantalla de instalación de WordPress en lugar de su web, deténgase. Normalmente significa que WordPress está conectado a una base de datos vacía o distinta, no que su contenido haya desaparecido. No complete la instalación.

¿Cuándo debe pedir soporte técnico?

Pida ayuda cuando:

el error persista y el proveedor de hosting diga que por su parte todo está bien
el error haya aparecido después de una migración o una restauración
el sitio gestione pedidos, reservas, suscripciones o datos de clientes
el error vuelva a aparecer en los periodos de más actividad
el escritorio indique que hay que reparar la base de datos
no se sienta cómodo editando wp-config.php
no esté seguro de que una copia de seguridad reciente sea fiable
sospeche que la web puede haber sido comprometida

No necesita identificar usted mismo la causa primero. Una solicitud útil puede limitarse a describir lo que ve, cuándo empezó y qué ha cambiado.

¿Qué información debe recopilar?

Estos datos son útiles:

la URL de la web
una captura de pantalla del error
cuándo empezó el problema
si el error es constante o intermitente
cualquier cambio reciente, como una migración, un cambio de contraseña o una restauración
el nombre del proveedor de hosting
cualquier correo o respuesta a un ticket del proveedor de hosting
si están afectadas otras webs de la misma cuenta
si hay disponible una copia de seguridad reciente

No envíe contraseñas de la base de datos ni credenciales del hosting por correo electrónico normal. D4Hub puede indicarle qué accesos se necesitan y cómo compartirlos de forma segura.

Cómo puede ayudarle D4Hub

El objetivo no es solo hacer desaparecer el error, sino entender por qué falló la conexión y reducir la probabilidad de que vuelva a ocurrir.

Según la situación, D4Hub puede ayudarle a:

revisar los datos de conexión a la base de datos que usa WordPress
coordinarse con su proveedor de hosting para confirmar el estado del servidor de base de datos
corregir problemas de configuración tras una migración o un cambio de contraseña
revisar y reparar de forma segura las tablas dañadas de la base de datos
investigar sobrecargas, consultas lentas o plugins que presionan la base de datos
revisar los límites del hosting y recomendar una configuración más adecuada
valorar si es necesario restaurar una copia de seguridad y qué datos podría sobrescribir
probar el inicio de sesión, los formularios, el checkout y otras funciones clave cuando la web vuelva a estar en línea

Puede pedir ayuda en cualquier fase, tanto si acaba de ver el error como si ya ha hablado con su proveedor de hosting o ha probado una solución que no ha funcionado.

Abrir un ticket de soporte

Para usuarios con conocimientos técnicos: comprobar la conexión a la base de datos

Las siguientes comprobaciones están pensadas para quienes se manejan con SFTP, SSH, WP-CLI y el panel de su hosting.

Antes de cambiar nada, descargue una copia de wp-config.php y, si es posible, haga una copia de seguridad de la base de datos. No pegue nunca wp-config.php, contraseñas ni registros completos en foros públicos ni en chats de soporte.

Revise los datos de la base de datos en wp-config.php

Abra wp-config.php, normalmente en la carpeta principal de WordPress, y busque estas líneas:

define( 'DB_NAME', 'database_name' );
define( 'DB_USER', 'database_user' );
define( 'DB_PASSWORD', 'database_password' );
define( 'DB_HOST', 'localhost' );

Compare cada valor con lo que muestra su panel de hosting para la base de datos y su usuario. Preste atención a:

los prefijos que algunos hostings añaden automáticamente a los nombres de la base de datos y del usuario
DB_HOST, que no siempre es localhost: algunos proveedores usan un nombre de host independiente, un puerto como localhost:3306 o la ruta de un socket
las contraseñas que contienen una comilla simple o una barra invertida, que deben escaparse dentro de la cadena PHP

Si cambia un valor, cambie una sola cosa cada vez y recargue la web después de cada cambio.

Con WP-CLI puede leer los valores sin abrir el archivo:

wp config get DB_NAME
wp config get DB_USER
wp config get DB_HOST

Pruebe la conexión con el cliente mysql

Si tiene acceso SSH, intente conectarse con los mismos datos que usa WordPress:

mysql -h localhost -u database_user -p database_name

Sustituya localhost, database_user y database_name por sus propios valores. La opción -p hace que el cliente le pida la contraseña en lugar de guardarla en el historial de la shell.

Si la conexión funciona, enumere las tablas:

SHOW TABLES;

Después escriba exit para salir.

Cómo interpretar el resultado:

"Access denied": el usuario, la contraseña o los permisos son incorrectos
"Unknown database": el nombre de la base de datos es incorrecto o la base de datos ya no existe
"Can't connect" o un tiempo de espera agotado: el valor del host es incorrecto o el servidor de base de datos está caído
la conexión funciona pero no hay tablas: WordPress apunta a una base de datos vacía

Revise las tablas con WP-CLI

Si la conexión funciona, WP-CLI puede revisar las tablas usando los datos de wp-config.php:

wp db check

La salida enumera cada tabla con su estado. Las tablas indicadas como corruptas o dañadas (corrupted, crashed) apuntan a una base de datos dañada más que a un problema de conexión.

WP-CLI también ofrece wp db repair. Úselo solo cuando tenga una copia de seguridad de la base de datos y, preferiblemente, con la participación de su proveedor de hosting o de un desarrollador si la base de datos es grande o el sitio gestiona pedidos.

Use la página de reparación de WordPress solo como último paso

WordPress incluye una herramienta de reparación integrada. Para activarla, añada esta línea a wp-config.php, antes de la línea que dice "That's all, stop editing" (en las instalaciones en español, "¡Eso es todo, deja de editar!"):

define( 'WP_ALLOW_REPAIR', true );

Después abra:

https://example.com/wp-admin/maint/repair.php

Importante: mientras esta línea esté activa, cualquiera puede abrir la página de reparación sin iniciar sesión. Elimine la línea de wp-config.php en cuanto termine la reparación y compruebe que la página ya no funciona.

Haga una copia de seguridad de la base de datos antes de ejecutar la reparación, y no la use si no está seguro de que el problema sea la corrupción de tablas.

Revise los registros de errores del hosting

La mayoría de los paneles de hosting dan acceso a los registros de errores de PHP o del servidor. Busque errores registrados en el momento en que la web dejó de funcionar, como conexiones rechazadas, demasiadas conexiones o un disco lleno.

Los registros pueden contener información sensible. Revíselos antes de compartirlos y compártalos solo a través de un canal seguro.

D4Hub puede ayudarle a interpretar los resultados de estas comprobaciones y a decidir el siguiente paso más seguro.

Preguntas frecuentes

¿Este error significa que han hackeado mi web?

Normalmente no. Las causas más comunes son problemas del hosting o datos de conexión incorrectos. Un compromiso es posible, por ejemplo si alguien ha modificado wp-config.php o la contraseña de la base de datos, pero es una posibilidad entre varias. Si además nota usuarios desconocidos, redirecciones extrañas o archivos inesperados, menciónelo cuando pida ayuda.

¿Por qué el error aparece solo algunas veces?

Un error intermitente suele significar que el servidor de base de datos está sobrecargado o que la cuenta está alcanzando un límite de conexiones. Los picos de tráfico, los bots, los plugins pesados o las tareas programadas pueden contribuir. El proveedor de hosting normalmente puede ver cuándo se alcanzó el límite.

He cambiado la contraseña de la base de datos y ahora la web no funciona. ¿Qué ha pasado?

WordPress sigue teniendo la contraseña antigua en wp-config.php. La nueva contraseña también debe escribirse en la línea DB_PASSWORD. Si no se siente cómodo editando el archivo, su proveedor de hosting o D4Hub pueden ayudarle.

¿Debo restaurar una copia de seguridad?

No como primer paso. Si la causa es un ajuste incorrecto o un problema del servidor de base de datos, una restauración no servirá de nada y puede sobrescribir pedidos, mensajes o contenidos más recientes. Restaurar solo tiene sentido una vez entendida la causa y comprobada la copia.

El escritorio dice que hay que reparar la base de datos. ¿Es seguro?

La herramienta de reparación integrada está pensada para esto, pero haga antes una copia de seguridad de la base de datos y recuerde eliminar después la línea WP_ALLOW_REPAIR. Si el sitio gestiona pedidos o datos de clientes, plantéese pedir ayuda antes de ejecutarla.

¿Por qué mi web muestra ahora la pantalla de instalación de WordPress?

Normalmente significa que WordPress está conectado a una base de datos vacía o distinta de la original, o que el prefijo de tablas de wp-config.php no coincide con las tablas existentes. No complete la instalación. Revise el nombre de la base de datos y el prefijo de tablas, o pida ayuda.

¿Puede ayudarme D4Hub si el proveedor de hosting dice que todo está bien?

Sí. Comparta lo que le ha dicho el proveedor de hosting y lo que ya ha probado. D4Hub puede revisar la configuración, la base de datos y la propia web para encontrar dónde falla la conexión.

¿Por qué WordPress muestra un error al establecer una conexión con la base de datos?