Error de Conexión a Base de Datos en WordPress | Solución

¿Tu página de WordPress muestra el temido mensaje "Error establishing a database connection" o "Database connection failed"?

No te preocupes. Este es uno de los errores más comunes en WordPress y, aunque parece grave, en la mayoría de los casos tiene una solución rápida y sencilla. Este aviso significa que WordPress no puede comunicarse con tu base de datos, donde se almacenan tus entradas, páginas, comentarios y configuraciones.

En esta guía paso a paso, te explicaré cómo solucionar el error conexion wordpress sin necesidad de ser un experto en programación. Vamos a ir desde las causas más simples hasta las más complejas, con instrucciones claras para que puedas restaurar tu sitio en pocos minutos.

¿Qué significa exactamente "Database connection failed"?

Para entenderlo fácilmente, imagina que tu web es una tienda. El escaparate (tu sitio) necesita acceso al almacén (la base de datos) para mostrar los productos. Si la puerta del almacén está cerrada con llave, la contraseña ha cambiado o el edificio se ha incendiado, el escaparate se queda vacío y muestra el error.

En términos técnicos, WordPress necesita cuatro datos para conectarse a tu base de datos wordpress:

El nombre de la base de datos.
El usuario de la base de datos.
La contraseña de ese usuario.
El servidor de la base de datos (normalmente localhost).

Si cualquiera de estos datos es incorrecto, o si el servidor de bases de datos está caído o saturado, verás el error.

Paso 1: La solución rápida (y casi mágica)

Antes de tocar nada técnico, prueba esto. A veces el error es temporal y se soluciona solo.

1.1. Recarga la página varias veces

Pulsa F5 o el botón de recargar en tu navegador. Si tienes suerte, el servidor de bases de datos estaba haciendo un "parpadeo" y se recuperará.

1.2. Reinicia tu router y tu equipo

Si el error aparece en todos tus dispositivos, el problema no es tuyo, pero un reinicio local puede ayudar a descartar problemas de red. Apaga el router durante 30 segundos y reinicia tu ordenador o móvil.

1.3. Revisa si el problema es general

Visita webs como DownDetector o busca en Twitter si tu proveedor de hosting tiene problemas reportados. Si es un fallo masivo, solo te queda esperar.

[INFO] Si después de 15 minutos el error persiste, pasa al siguiente paso. La paciencia es clave, pero no te quedes esperando horas.

Paso 2: Revisa tus credenciales en wp-config.php

Este es el archivo de configuración principal de WordPress. Aquí es donde se guardan los datos de acceso a la base de datos. Un error muy común es que estos datos se hayan cambiado o estén mal escritos.

2.1. Accede a tu hosting

Para editar este archivo, necesitas acceder a tu panel de control de hosting. Si usas Syspanel (recuerda que el puerto de acceso es el 2106), inicia sesión con tus credenciales.

2.2. Abre el archivo wp-config.php

Dentro de tu panel de archivos o usando el Administrador de Archivos, navega hasta la carpeta raíz de tu instalación de WordPress (normalmente public_html o www). Busca el archivo llamado wp-config.php.

2.3. Verifica los datos

Abre el archivo con un editor de texto (como el Bloc de notas o el editor del propio panel) y busca las líneas que dicen:

define('DB_NAME', 'tu_nombre_de_base');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Comprueba que estos datos son correctos. Si no los recuerdas, puedes encontrarlos en tu panel de control de hosting, en la sección de "Bases de Datos MySQL".

[WARNING] No cambies estos datos a menos que sepas lo que estás haciendo. Un error aquí puede empeorar las cosas. Si todo parece correcto, no lo modifiques y pasa al siguiente paso.

Paso 3: Repara tu base de datos (función integrada)

WordPress tiene una herramienta secreta que puede reparar bases de datos dañadas. Es muy fácil de activar.

3.1. Añade una línea al wp-config.php

En el mismo archivo wp-config.php, justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, añade esta línea:

define('WP_ALLOW_REPAIR', true);

3.2. Accede a la herramienta de reparación

Guarda el archivo y visita esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php

3.3. Ejecuta la reparación

Verás una pantalla con dos botones. Haz clic en "Reparar base de datos". Espera a que termine. Después, vuelve a tu web.

3.4. Elimina la línea de seguridad

IMPORTANTE: Una vez reparada, borra la línea define('WP_ALLOW_REPAIR', true); que añadiste. Dejar esa línea activa es un riesgo de seguridad grave, ya que cualquiera podría reparar (o dañar) tu base de datos.

[TIP] Esta herramienta es muy útil si el error aparece después de una actualización de WordPress o de un plugin.

Paso 4: Comprueba el servidor de la base de datos

El error database connection failed también puede ocurrir si el servidor de bases de datos (MySQL o MariaDB) está caído o sobrecargado.

4.1. Reinicia el servicio desde tu hosting

Si tu hosting te da acceso a un panel como cPanel, Plesk o Syspanel, busca la sección de "Servicios" o "Procesos". A veces puedes reiniciar el servicio de MySQL desde ahí.

4.2. Contacta con tu proveedor de hosting

Si no ves esa opción, o si el reinicio no funciona, contacta con el soporte técnico de tu hosting. Diles que tienes un "error de conexión a la base de datos" y que sospechas que el servidor MySQL está caído. Ellos podrán reiniciarlo o decirte si hay una incidencia.

[INFO] Si tienes un hosting compartido, es posible que un vecino "pesado" esté saturando el servidor. El soporte técnico es quien puede solucionarlo.

Paso 5: Optimiza tu base de datos (si es un problema de rendimiento)

A veces, la base de datos está tan llena de basura (revisiones antiguas, transients, spam) que tarda demasiado en responder y WordPress no puede conectarse a tiempo.

5.1. Usa un plugin de optimización

Si puedes acceder a tu panel de administración (/wp-admin) aunque sea de forma intermitente, instala un plugin como WP-Optimize o Advanced Database Cleaner.

5.2. Limpia lo esencial

Estos plugins te permiten:

Eliminar revisiones de entradas antiguas.
Borrar comentarios spam.
Limpiar la caché de transients (datos temporales).
Optimizar las tablas de la base de datos.

Esta limpieza reduce el tamaño de la base de datos y mejora la velocidad de respuesta, evitando futuros errores de conexión.

Paso 6: Cambia el host de la base de datos (solución avanzada)

En algunos casos, especialmente si tu web tiene mucho tráfico o usa un CDN, el problema puede ser el valor DB_HOST.

6.1. Prueba con 127.0.0.1

En lugar de localhost, prueba a cambiar la línea de DB_HOST a 127.0.0.1. A veces, el servidor tarda menos en resolver esa IP que el nombre "localhost".

6.2. Consulta con tu hosting

Algunos hosts tienen un hostname específico para la base de datos (por ejemplo, db.miweb.com). Consulta la documentación de tu proveedor o el panel de control para ver si debes usar otro valor.

[WARNING] Este paso es delicado. Si pones un valor incorrecto, el error persistirá. Anota siempre el valor original antes de cambiarlo.

Paso 7: Verifica los permisos de archivos

Los archivos de WordPress tienen permisos que controlan quién puede leerlos, escribirlos o ejecutarlos. Si los permisos son demasiado restrictivos, WordPress no puede leer el archivo wp-config.php correctamente.

7.1. Configura los permisos correctos

Desde tu administrador de archivos o cliente FTP, selecciona todos los archivos de la raíz y establece los permisos en 644 para archivos y 755 para carpetas.

Archivos: 644
Carpetas: 755

7.2. Cuidado con el wp-config.php

El archivo wp-config.php debe tener permisos 600 o 640 para máxima seguridad. Si tiene permisos 777, WordPress podría no leerlo bien y fallar.

[TIP] Si no sabes cómo cambiar permisos, busca un tutorial específico para tu panel de control o usa un cliente FTP como FileZilla.

Paso 8: Restaura una copia de seguridad

Si has llegado hasta aquí y nada funciona, es hora de pensar en restaurar una copia de seguridad de tu sitio.

8.1. Usa una copia del hosting

La mayoría de los proveedores de hosting ofrecen copias de seguridad automáticas. En Syspanel o cPanel, busca la sección de "Copias de Seguridad" o "Backups". Restaura la versión más reciente que funcione.

8.2. Restaura manualmente

Si tienes un plugin de backup (como UpdraftPlus), puedes restaurar desde el propio plugin, pero necesitarás acceso a /wp-admin. Si no lo tienes, tendrás que restaurar los archivos y la base de datos manualmente desde tu panel de hosting.

[INFO] Restaurar una copia de seguridad es la solución más efectiva si has roto algo recientemente (como un plugin o un cambio en el tema).

Paso 9: Contacta con soporte especializado

Si después de todos estos pasos el error "Database connection failed" persiste, es hora de pedir ayuda profesional.

9.1. Prepara la información

Antes de contactar, ten a mano:

Tu nombre de usuario y dominio.
El mensaje de error exacto.
Los pasos que ya has probado.
La fecha en la que empezó el problema.

9.2. Contacta con tu hosting primero

Ellos son los únicos que pueden ver los logs del servidor y saber si hay un problema a nivel de infraestructura. Diles que ya has revisado el wp-config.php y que has intentado reparar la base de datos.

[TIP] Si tu hosting no te da una solución, busca un desarrollador WordPress freelance. A veces, un problema en un plugin o un tema muy específico requiere ojos expertos.

Preguntas Frecuentes (FAQ)

¿Por qué me sale este error después de mover mi web?

Es muy común. Al mover la web a un nuevo servidor, los datos de la base de datos cambian. Revisa el wp-config.php y asegúrate de que los datos son los del nuevo hosting.

¿Puede un plugin causar este error?

Sí, aunque es raro. Un plugin mal codificado puede saturar la base de datos o modificar las tablas. Si el error empezó tras instalar un plugin, desactívalo renombrando su carpeta en /wp-content/plugins/ a través del FTP.

¿Qué hago si veo "Error establishing a database connection" en el móvil pero no en el PC?

Puede ser un problema de caché local o de DNS. Prueba a borrar la caché del navegador del móvil o a usar una VPN para descartar problemas de red.

¿Es lo mismo "Database connection failed" que "Error al conectar con la base de datos"?

Sí, son el mismo error en diferentes idiomas o contextos. La solución es idéntica.

¿Cada cuánto debo optimizar mi base de datos?

Se recomienda hacerlo al menos una vez al mes si publicas contenido con frecuencia. La optimización previene errores de conexión y acelera tu web.

Resumen final

El error database connection failed puede ser alarmante, pero es un problema solucionable. La clave está en ir paso a paso:

Prueba lo simple: recarga y reinicia.
Revisa tus credenciales en wp-config.php.
Repara la base de datos con la herramienta integrada.
Comprueba el servidor de tu hosting.
Optimiza si es un problema de rendimiento.
Restaura una copia de seguridad si es necesario.

La mayoría de las veces, el problema se resuelve en el Paso 2 o 3. No te rindas y recuerda que tu proveedor de hosting está para ayudarte. Con un poco de paciencia y esta guía, tu web volverá a estar en línea en poco tiempo. ¡Mucho ánimo!