Las verdaderas razones por las que falla la conexión a la base de datos de tu WordPress (+ Cómo solucionarlo)

Todavía recuerdo el pánico que sentí al ver esas cinco palabras: “Error al establecer una conexión con la base de datos”.

Un minuto mi sitio de WordPress funcionaba perfectamente, al siguiente, nada más que una pantalla en blanco con este críptico mensaje.

La parte más frustrante fue darme cuenta de cuántas cosas diferentes podían causar el mismo mensaje de error.

¿Fue mi proveedor de hosting? ¿Hice algún cambio que lo rompió? ¿Estaba bajo ataque?

Si te enfrentas a este error ahora mismo, respira hondo. Vas a aprender exactamente qué causa este problema común de WordPress, cómo diagnosticarlo correctamente la primera vez y, lo más importante, cómo solucionarlo rápidamente y evitar que vuelva a suceder.

Aquí están los puntos clave:

• El error al establecer una conexión con la base de datos significa que WordPress no puede comunicarse con tu base de datos; tu contenido sigue siendo seguro, solo inaccesible.
• Las causas más comunes incluyen credenciales de base de datos incorrectas, archivos de WordPress corruptos, sobrecarga del servidor o problemas de hosting.
• Haz siempre una copia de seguridad de tu sitio antes de intentar solucionarlo.
• Restaurar una copia de seguridad reciente suele ser la solución más rápida.
• Empieza a solucionar problemas con soluciones sencillas (comprobando credenciales) antes de pasar a soluciones complejas (creando nuevas bases de datos).
• Evita los errores de conexión a la base de datos mediante copias de seguridad regulares, actualizaciones y optimización de la base de datos.

Tabla de Contenidos

WordPress utiliza una base de datos para hacer un seguimiento de todo en tu sitio. Esto incluye tus publicaciones, páginas, comentarios, información de usuario y configuraciones. Cada vez que alguien visita tu sitio, WordPress necesita obtener esta información de la base de datos para mostrar tu contenido.

Cuando ocurre el problema de conexión a la base de datos, WordPress no puede recuperar ninguna de esta información. No puede construir tus páginas web ni mostrar tu contenido a los visitantes.

En lugar de tu sitio web, los usuarios ven una pantalla blanca completamente en blanco o un simple mensaje de error. El contenido está ahí, pero simplemente no puedes acceder a él.

Este error afecta a todo tu sitio. No podrás acceder a tu panel de administración, publicar contenido nuevo ni realizar ningún cambio. Tu sitio está esencialmente fuera de línea hasta que se restablezca la conexión a la base de datos de WordPress.

Aunque sea frustrante, recuerda que tu contenido no ha desaparecido. Todavía está almacenado de forma segura en la base de datos. Solo necesitamos arreglar la conexión para que todo vuelva a funcionar.

¿Qué causa el error de conexión a la base de datos en WordPress?

El error de conexión a la base de datos es un problema común en WordPress y puede ocurrir por varias razones. Vamos a desglosar los culpables más comunes.

Las credenciales de inicio de sesión incorrectas de la base de datos suelen ser las culpables. WordPress necesita el nombre de usuario, la contraseña y el nombre de la base de datos correctos para conectarse. Si alguno de estos detalles es incorrecto, verás este error.

A veces, tus archivos de WordPress pueden corromperse. Esto podría suceder durante una actualización fallida o si tu sitio es hackeado. Estos archivos principales corruptos pueden interrumpir la conexión a tu base de datos.

Tu servidor de base de datos podría estar experimentando problemas. Si está sobrecargado o temporalmente inactivo, WordPress no puede conectarse a él.

Muchos sitios residen en planes de alojamiento compartido de WordPress. Si tu sitio se vuelve popular de repente y excede los límites de tu plan de alojamiento, podría perder su conexión a la base de datos.

Las discrepancias en la versión de PHP también pueden causar este error. Si tu proveedor de alojamiento actualiza PHP pero tu versión de WordPress no es compatible, puede provocar problemas de conexión.

Por último, el malware o los intentos de hackeo pueden interrumpir las funciones normales de tu sitio, incluida su conexión a la base de datos.

Cómo Solucionar el Error de Establecimiento de una Conexión a Base de Datos en WordPress

Ahora que entendemos qué causa este error, vamos a ponernos manos a la obra y solucionarlo. Recorreremos varios métodos, paso a paso. 

Aquí tienes un resumen rápido de cómo solucionar los errores de conexión a la base de datos:

• Restaurar una Copia de Seguridad: Utiliza la recuperación ante desastres (de plugins como Duplicator) para una reversión instantánea
• Comprobar las Credenciales de la Base de Datos: Verifica el nombre de usuario, la contraseña y el nombre de la base de datos en wp-config.php
• Comprobar la Información del Host de la Base de Datos: Confirma la dirección del servidor correcta
• Reparar tu Base de Datos: Utiliza la herramienta de reparación integrada de WordPress para bases de datos corruptas
• Comprobar el Estado del Servidor: Ponte en contacto con tu proveedor de alojamiento para ver si el servidor de la base de datos está inactivo o sobrecargado
• Reparar Archivos Corruptos: Reemplaza los archivos principales de WordPress con copias nuevas
• Crear una Nueva Base de Datos: Empieza de nuevo con una nueva base de datos y credenciales de usuario
• Actualizar la URL del Sitio: Corrige las discrepancias de URL después de cambios de dominio o protocolo
• Reiniciar el Servidor Web: Reinicia el servidor para solucionar problemas temporales
• Contactar con Soporte: Obtén ayuda profesional cuando las soluciones DIY no funcionen

Recuerda que siempre es una buena idea hacer una copia de seguridad de tu sitio antes de realizar cualquier cambio.

1. Restaura una copia de seguridad

A veces, la solución más sencilla es la mejor. Si tienes una copia de seguridad reciente de tu sitio de antes de que ocurriera el error, restaurarla podría solucionar rápidamente tu problema.

Las copias de seguridad periódicas son como una red de seguridad para tu sitio web. Pueden ahorrarte horas de solución de problemas y hacer que tu sitio vuelva a estar en línea rápidamente.

Con Duplicator, puedes restaurar fácilmente tu sitio después de errores devastadores. Tiene una función de recuperación ante desastres que te proporciona un enlace de recuperación si algo sale mal.

El error al establecer la conexión con la base de datos normalmente te impedirá acceder a tu panel de administración. Pero puedes pegar este enlace de recuperación en un navegador para revertir tu sitio.

Restaurar una copia de seguridad funciona mejor cuando el error se debe a cambios recientes, como una actualización de un plugin o un tema nuevo. Es como pulsar el botón de deshacer para todo tu sitio.

También puedes restaurar una copia de seguridad directamente desde Duplicator Cloud cuando tu wp-admin no funciona. Configura el conector de recuperación con las credenciales FTP de tu sitio.

Luego, programa copias de seguridad automáticas a Duplicator Cloud. Si alguna vez notas problemas a gran escala, busca una copia de seguridad reciente en la nube y restáurala.

Para más detalles, lee mi guía sobre cómo restaurar un sitio de WordPress a partir de una copia de seguridad.

Si no tienes una copia de seguridad reciente, no te preocupes. Tenemos muchos otros métodos para intentar. 

¡Que esto sirva como recordatorio para configurar copias de seguridad periódicas para tu sitio! Podría ahorrarte muchos dolores de cabeza en el futuro.

2. Comprueba tus credenciales de base de datos

A menudo, el error de conexión a la base de datos se debe simplemente a credenciales de inicio de sesión incorrectas. Si acabas de mudarte a un nuevo proveedor de hosting, tu sitio podría estar intentando conectarse a la base de datos antigua en lugar de la nueva. 

Asegurémonos de que WordPress tenga la información correcta para acceder a tu base de datos.

Necesitarás revisar tu archivo wp-config.php. Este archivo contiene los detalles de inicio de sesión de tu base de datos. 

Primero, conéctate a tu sitio web usando FTP, cPanel o el administrador de archivos de tu proveedor de hosting. Busca el archivo wp-config.php en el directorio principal de WordPress (public_html).

Abre este archivo y busca las líneas que comienzan con:

• DB_NAME
• DB_USER
• DB_PASSWORD
• DB_HOST

Estas líneas indican a WordPress cómo conectarse a tu base de datos. Asegúrate de que la información aquí coincida con tus credenciales reales de la base de datos de WordPress.

Si no estás seguro de cuáles deberían ser, inicia sesión en tu panel de control de hosting. Busca una sección sobre bases de datos o MySQL. Deberías encontrar allí el nombre de tu base de datos, nombre de usuario y contraseña.

Para usuarios de BlueHost, puedes hacer clic en Websites » Advanced. En el cuadro Databases, pulsa Manage.

Esto abrirá los detalles de tu base de datos en cPanel. 

Si no estás seguro de cuál es tu contraseña actual, desplázate hacia abajo hasta Current Users y cambia tu contraseña.

Si algún detalle en wp-config.php no coincide, actualízalo. Guarda el archivo wp-config.php y súbelo de nuevo a tu servidor si estás usando FTP.

Después de actualizar, intenta acceder a tu sitio de nuevo. Si el error desaparece, ¡genial! Has resuelto el problema.

3. Comprueba la información de tu host de base de datos

A veces, la información del host de la base de datos en tu archivo wp-config.php podría ser incorrecta. Esto es especialmente común si has trasladado recientemente tu sitio a un nuevo host.

En tu archivo wp-config.php, busca una línea que comience con DB_HOST

Para la mayoría de los sitios de WordPress, esto está configurado como 'localhost'. Pero no siempre es así.

Algunos proveedores de alojamiento utilizan una dirección diferente para sus servidores de bases de datos. Podrías ver algo como '127.0.0.1' o un nombre de servidor específico.

Si no estás seguro de cuál debería ser, ponte en contacto con tu proveedor de alojamiento. Ellos pueden proporcionarte la información correcta del host de la base de datos.

Una vez que tengas la información correcta, actualiza la línea DB_HOST en tu archivo wp-config.php. Guarda los cambios y sube el archivo de nuevo a tu servidor.

Recuerda, incluso los detalles más pequeños, como una letra faltante o un espacio adicional, pueden causar problemas de conexión. Revisa todo dos veces para asegurarte de que sea exactamente correcto.

4. Repara tu base de datos

A veces, tu base de datos podría estar corrupta. Por suerte, WordPress tiene una herramienta de reparación de bases de datos integrada. 

Primero, necesitarás habilitar la herramienta de reparación. Abre de nuevo tu archivo wp-config.php. Añade esta línea justo antes de "That’s all, stop editing!":

define('WP_ALLOW_REPAIR', true);

Ahora, en tu navegador web, ve a esta dirección:

http://www.yoursite.com/wp-admin/maint/repair.php

Reemplaza "yoursite.com" con el nombre de tu dominio real.

Verás dos opciones: Reparar Base de Datos y Reparar y Optimizar Base de Datos. Empieza con la primera opción. Si no funciona, prueba la segunda.

Haz clic en el botón y deja que WordPress haga su trabajo. Este proceso podría tardar unos minutos, dependiendo del tamaño de tu base de datos.

Una vez que termine, intenta acceder a tu sitio de nuevo. Recuerda eliminar la línea que añadiste al archivo wp-config.php para deshabilitar la herramienta de reparación.

5. Comprueba si tu servidor de base de datos está caído

A veces, el problema no está en tu sitio de WordPress en absoluto. Tu servidor de base de datos podría estar teniendo problemas.

Los signos de una interrupción del servidor de base de datos incluyen:

• Múltiples sitios web en la misma cuenta de alojamiento muestran errores similares
• No puedes acceder a tu panel de control de alojamiento o a phpMyAdmin
• Tu host informa de problemas con la base de datos

Si sospechas de un problema del servidor, ponte en contacto con tu proveedor de alojamiento. Ellos pueden confirmar si hay una interrupción y darte una estimación de cuándo se solucionará.

También puedes probar la conexión tú mismo. Abre phpMyAdmin y selecciona el nombre de tu base de datos. Si puedes hacerlo, tu base de datos sigue activa.

Ahora, comprueba si tu usuario de base de datos tiene permisos suficientes. Crea un nuevo archivo y nómbralo testconnection.php. Pega el siguiente código en él:

<?php

$link = mysqli_connect('localhost', 'username', 'password');

if (!$link) {

die('Could not connect: ' . mysqli_error());

}

echo 'Connected successfully';

mysqli_close($link);

?>

Asegúrate de reemplazar el nombre de usuario y la contraseña con los detalles correctos para tu base de datos.

Sube el nuevo archivo a tu sitio web. Si puedes acceder a él en un navegador web, tu usuario tiene acceso suficiente. 

Mientras esperas que el servidor vuelva a estar en línea, no hay mucho que puedas hacer para solucionar el error. Sin embargo, puedes configurar una página de mantenimiento temporal para informar a tus visitantes de lo que está sucediendo.

Para hacer esto, te recomiendo usar SeedProd. Este es un popular constructor de páginas de destino que puede ayudarte a diseñar una página en modo de mantenimiento en segundos.

Las interrupciones del servidor suelen resolverse r ilde{p}idamente, pero nos recuerdan lo importante que es un proveedor de alojamiento fiable. Si experimentas estos problemas con frecuencia, puede que sea hora de considerar un cambio de proveedor.

Ten en cuenta que este m ilde{e}todo no soluciona activamente nada. Sin embargo, identificar un problema del servidor puede ahorrarte horas de soluci ilde{o}n de problemas innecesaria.

6. Repara archivos corruptos de WordPress

A veces, los archivos principales de tu WordPress pueden corromperse. Esto puede ocurrir durante una actualizaci ilde{o}n, despu ilde{e}s de un intento de hackeo o debido a errores de transferencia de archivos. 

Los archivos corruptos pueden causar todo tipo de problemas, incluidos errores de conexi ilde{o}n con la base de datos.

Para solucionar esto, necesitar ilde{a}s reemplazar tus archivos principales de WordPress por copias nuevas. No te preocupes, esto no afectar ilde{a} a tu contenido ni a tu configuraci ilde{o}n. 

Sin embargo, eliminar ilde{a} cualquier c ilde{o}digo personalizado en tus archivos .htaccess y wp-config.php. Aseg ilde{u}rate de hacer una copia de seguridad de estos archivos antes de continuar. 

A continuaci ilde{o}n, descarga una copia nueva de WordPress desde wordpress.org.

Descomprime el archivo en tu ordenador. Elimina la carpeta wp-content y el archivo wp-config-sample.php de esta copia nueva.

Ahora, utiliza FTP para subir el resto de los archivos de WordPress a tu servidor. Cuando se te pregunte, elige sobrescribir los archivos existentes.

Este proceso reemplaza todos los archivos principales de WordPress por versiones limpias. Tus temas, plugins y subidas est ilde{a}n seguros en la carpeta wp-content, que no hemos tocado.

Despu ilde{e}s de que la subida se complete, intenta acceder a tu sitio de nuevo. Si tu sitio funciona ahora, es probable que los archivos principales corruptos fueran los culpables.

Si a ilde{u}n ves el error, los archivos de tu tema o plugin tambi ilde{e}n podr ilde{i}an causar este problema. Intenta desactivar todos los plugins y cambiar a un tema predeterminado de WordPress para ver si eso soluciona el problema.

Recuerda, mant ilde{e}n siempre tu instalaci ilde{o}n de WordPress, temas y plugins actualizados para minimizar el riesgo de corrupci ilde{o}n de archivos.

7. Crea una nueva base de datos

Cuando todo lo dem ilde{a}s falla, empezar de cero puede ser la mejor soluci ilde{o}n. Crear una base de datos nueva puede sonar desalentador, pero es m ilde{a}s sencillo de lo que crees. 

Para crear una base de datos nueva, normalmente usar ilde{a}s el panel de control de tu alojamiento. La mayor ilde{i}a de los proveedores ofrecen cPanel, lo que facilita este proceso. Busca la opci ilde{o}n MySQL Databases, que suele estar en la secci ilde{o}n Databases.

Una vez all ilde{i}, ver ilde{a}s un campo para introducir un nombre de base de datos nuevo. Elige algo descriptivo, pero evita espacios o caracteres especiales.

Haz clic en Create Database, ¡y listo! Tienes una base de datos nueva.

Pero espera, a ilde{u}n no hemos terminado. Tu nueva base de datos necesita un usuario que pueda acceder a ella. En la misma ilde{a}rea, encontrar ilde{a}s una secci ilde{o}n para a tilde{a}dir un usuario nuevo.

Crea un usuario nuevo con una contrase tilde{a} segura. Recuerda, esta es la clave de los datos de tu sitio web, ¡as ilde{i} que hazla dif ilde{i}cil de descifrar!

Ahora, vincula tu nuevo usuario a la base de datos que acabas de crear. Normalmente encontrar ilde{a}s una opci ilde{o}n para Add User to Database. Selecciona tu nuevo usuario y base de datos, y luego otorga todos los privilegios.

¿Has creado una nueva base de datos y configurado un usuario. Pero ¿cómo soluciona esto nuestro error de conexión?

Esta es la parte crucial: necesitas actualizar la configuración de WordPress para usar esta nueva base de datos. 

¿Recuerdas el archivo wp-config.php que mencionamos antes? Es hora de editarlo de nuevo.

Abre wp-config.php y actualiza los campos DB_NAME, DB_USER y DB_PASSWORD con la información de tu nueva base de datos. Guarda el archivo y súbelo de nuevo a tu servidor.

8. Actualiza la URL del sitio de WordPress

¿Por qué podría necesitar actualizarse la URL de tu sitio? Bueno, quizás has movido tu sitio a un nuevo dominio. O tal vez has cambiado de HTTP a HTTPS. Estos cambios pueden impedir que tu sitio web se conecte a la base de datos.

Para actualizar la URL de tu sitio, abre phpMyAdmin y selecciona tu base de datos. Pulsa la pestaña SQL.

Pega la siguiente consulta MySQL:

UPDATE wp_options SET option_value='YOUR_SITE_URL' WHERE option_name='siteurl'

Recuerda editar esta consulta para incluir tu nueva URL. 

9. Reinicia el servidor web

¿Has intentado apagarlo y encenderlo de nuevo? Esta vieja sabiduría de TI también se aplica a los servidores web.

Reiniciar tu servidor web a menudo puede solucionar problemas misteriosos, incluidos errores de conexión a la base de datos. Es como darle a tu sitio web un nuevo comienzo.

Cuando hablamos de reiniciar tu servidor web, normalmente nos referimos a un proceso que tu proveedor de hosting puede hacer por ti.

Si tienes un servidor dedicado, un servidor local o un servidor privado virtual (VPS), es posible que tengas una opción de reinicio en tu panel de hosting.

Alternativamente, puedes usar un cliente SSH para conectarte como usuario root y reiniciar tu servidor. Con una opción como PuTTY, este comando reiniciará los sistemas operativos Linux:

reboot

10. Contacta con soporte

El soporte profesional puede salvarte la vida cuando te enfrentas a problemas técnicos difíciles. Pero ¿a quién debes contactar?

El equipo de soporte de tu proveedor de hosting debería ser tu primera opción. Tienen acceso directo a tu servidor y a menudo pueden detectar problemas que no son visibles desde tu lado. Muchos hosts ofrecen soporte 24/7, así que no dudes en contactarlos, incluso a horas intempestivas.

Si tu host no puede resolver el problema, o si sospechas que es un problema específico de WordPress, los foros de soporte de WordPress son tu siguiente parada. Estos foros están llenos de miembros de la comunidad útiles y expertos de WordPress que probablemente ya han visto tu problema.

Para aquellos que ejecutan sitios críticos para el negocio, considera contratar a un profesional de WordPress. Su experiencia puede ser invaluable, especialmente si estás perdiendo ingresos debido a la inactividad.

Recuerda, hay toda una comunidad dispuesta a ayudar. No te atasques solo con problemas técnicos. A veces, un par de ojos nuevos es todo lo que se necesita para detectar la solución que te has estado perdiendo.

Cómo solucionar errores de conexión a la base de datos en localhost

Si estás construyendo tu sitio web sin conexión usando un entorno de servidor local, es posible que aún te encuentres con este frustrante error. Las configuraciones de localhost tienen sus propias peculiaridades, especialmente cuando se trata de credenciales de base de datos predeterminadas.

Antes de hacer cambios en wp-config.php, haz una copia de seguridad de tu sitio. ¡Incluso en un entorno local, siempre es mejor prevenir que curar! Puedes crear fácilmente una copia de seguridad local usando un plugin como Duplicator.

Una vez que tu copia de seguridad esté segura, abre tu archivo wp-config.php. Dependiendo del software local que estés utilizando (XAMPP, MAMP o LocalWP), aquí tienes una guía de cómo deberían verse tus credenciales:

• DB_NAME: Este es el nombre exacto de la base de datos que creaste en phpMyAdmin o en el panel de control de LocalWP.
• DB_USER: Para XAMPP, MAMP y generalmente LocalWP, el nombre de usuario predeterminado siempre es root.
• DB_PASSWORD: Here is where most people get tripped up!
  • XAMPP: Deja la contraseña completamente en blanco, como define( 'DB_PASSWORD', '' );
  • MAMP: La contraseña predeterminada es root.
  • LocalWP: LocalWP generalmente usa root por defecto, pero puedes verificarlo revisando la pestaña Database de tu sitio específico dentro del panel de control de LocalWP.
• DB_HOST: En la mayoría de los casos, será simplemente localhost. Sin embargo, si estás usando MAMP, es posible que ocasionalmente necesites añadir el número de puerto, quedando como localhost:8889.

Simplemente actualiza estos valores para que coincidan con tu software específico, guarda tu archivo y actualiza tu navegador. Tu sitio local debería volver a funcionar.

Cómo prevenir el error al establecer una conexión a la base de datos 

Exploremos algunos pasos proactivos que puedes tomar para mantener a raya los errores de conexión a la base de datos.

Primero: copias de seguridad, copias de seguridad, copias de seguridad. No puedo enfatizar esto lo suficiente. Si algo sale mal, siempre puedes restaurar una versión funcional de tu sitio. 

Intenta hacer una copia de seguridad de tu sitio al menos semanalmente, o diariamente para sitios con mucho tráfico. Con un plugin de copias de seguridad como Duplicator, puedes automatizar las copias de seguridad y proteger tus datos de forma regular.

A continuación, mantén todo actualizado. Esto incluye el núcleo de WordPress, los temas y los plugins. Las actualizaciones a menudo incluyen parches de seguridad y correcciones de errores que pueden prevenir problemas en la base de datos.

Si constantemente alcanzas los límites de recursos de tu servidor, podría ser el momento de actualizar tu plan de hosting. Un servidor sobrecargado puede provocar todo tipo de problemas, incluidos errores de conexión a la base de datos.

Cada plugin que añades es un punto potencial de fallo adicional. Utiliza plugins bien mantenidos y reputados, y no tengas miedo de eliminar aquellos que no estés utilizando activamente.

Plugins como Wordfence o Sucuri ayudan a proteger tu sitio de problemas de seguridad. Si hay algo mal con tu base de datos, lo sabrás antes de que tu sitio se caiga. 

También te recomiendo optimizar tu base de datos regularmente. Con el tiempo, las bases de datos pueden hincharse con datos innecesarios. Usa un plugin como WP-Optimize para mantener tu base de datos ágil y eficiente.

Tomar estas medidas puede parecer trabajo extra ahora mismo. Pero créeme, te lo agradecerás más tarde cuando tu sitio siga funcionando sin problemas.

Preguntas frecuentes sobre el error de conexión a la base de datos de WordPress

Conclusión

Los errores de conexión a la base de datos pueden ser frustrantes, pero con el enfoque correcto, puedes eliminarlos de tu sitio. 

¡Recuerda, la prevención es clave! El mantenimiento regular, las copias de seguridad y las actualizaciones pueden ahorrarte muchos dolores de cabeza en el futuro.

¿Listo para darle a tu sitio la protección que se merece? Prueba Duplicator Pro para copias de seguridad automáticas, restauraciones en un clic, almacenamiento en la nube ¡y mucho más!

Ya que estás aquí, creo que te gustarán estas guías adicionales de WordPress:

• Los 20 errores más comunes de WordPress (y algunas soluciones rápidas)
• Cómo Black Bike Media rescató una base de datos corrupta de 2,4 GB
• Lista de verificación de seguridad de WordPress: Guía paso a paso para proteger tu sitio
• Cómo Actualizar tu Base de Datos de WordPress (+Solucionar el Bucle de Actualización Requerida)
• Aquí están los pasos de reparación de la base de datos de WordPress que seguí yo mismo (sin necesidad de desarrollador)