Cómo solucionar el error «Establishing a Database Connection» en WordPress

¿Te gustaría ver más videos como este?
Echa un vistazo a nuestro canal de YouTube.

El mensaje de error "Failed to establish a database connection" indica un error fatal que hace que tu sitio WordPress sea inaccesible para los usuarios.

La razón de este error es que WordPress no puede conectarse a la base de datos. En este caso, varias variables diferentes afectan la conexión entre WordPress y la base de datos, lo que dificulta un poco la resolución de problemas para los principiantes.

Hemos preparado una lista de posibles razones para este error y una guía paso a paso para recuperar tu sitio WordPress lo antes posible.

¿Qué causa el mensaje de error "Error Establishing a Database Connection"?

El mensaje de error "Error Establishing a Database Connection" puede deberse a credenciales de base de datos incorrectas en tus ajustes de WordPress, a una base de datos corrupta o a un servidor de base de datos que no responde.

Imagen: Mensaje de error Error Establishing a Database Connection
This is what the error message «Error Establishing a Database Connection» looks like

¿Qué es una base de datos?

Para entender el problema, explicamos brevemente con qué estamos tratando:

Una base de datos es un software que facilita almacenar, organizar y recuperar datos de un software a otro.

WordPress actúa como un sistema de gestión de contenidos. Utiliza una base de datos para almacenar todo tu contenido y otros datos del sitio web. Se establece una conexión con la base de datos cada vez que se visita el sitio.

¿Qué datos necesita WordPress para establecer una conexión con la base de datos?

WordPress necesita la siguiente información:

  • Nombre de la base de datos
  • Nombre de usuario de la base de datos
  • Contraseña de la base de datos
  • Servidor de la base de datos

Esta información se guarda en tu archivo de configuración de WordPress con el nombre "wp-config.php".

Una vez que cualquiera de estos elementos es incorrecto, WordPress ya no puede conectarse a tu servidor de base de datos. Entonces obtienes el mensaje de error "Error Establishing a Database Connection".

Es uno de los errores más comunes de WordPress. Aparte de las credenciales incorrectas, este error también puede ocurrir si el servidor de base de datos ha fallado o los archivos de la base de datos están dañados.

Varias razones pueden causar este error; hemos listado los diferentes escenarios uno por uno. Si ya has probado uno de estos enfoques por tu cuenta, selecciona los siguientes pasos en la tabla de contenido superior.

Comenzaremos con el motivo más probable y luego abordaremos los menos comunes.

Verifica las credenciales de la base de datos de WordPress

La causa más común de fallo de conexión a la base de datos en WordPress son las credenciales de base de datos incorrectas.

Una de las razones de una conexión incorrecta a la base de datos de WordPress puede ser un traslado reciente de tu sitio WordPress a un nuevo host o servidor.

La información de inicio de sesión para la base de datos de WordPress se guarda en el archivo wp-config.php. Este archivo de configuración de WordPress contiene todos los ajustes básicos de WordPress, incluida la información de la base de datos.

Inicia sesión en tu sitio web usando un cliente FTP como FileZilla y busca las líneas siguientes en el archivo wp-config.php:

Imagen: Credenciales de la base de datos

Ahora debes asegurarte de que el nombre de la base de datos, el nombre de usuario y la contraseña son correctos.

Puedes comprobar esta información en el panel de tu cuenta de hosting de WordPress. Inicia sesión en tu cuenta de hosting y haz clic en "MySQL Databases" en la sección Base de datos.

Imagen: Cuenta de hosting de base de datos MySQL

Ahora serás llevado a la página de administración de la base de datos en tu panel de hosting. Aquí puedes ver el nombre de tu base de datos y el nombre de usuario.

Imagen: Información de la base de datos

Debajo están los usuarios de la base de datos y los enlaces para cambiar la contraseña de usuario.

Imagen: Usuario de la base de datos

Después de cotejar el nombre de la base de datos, el nombre de usuario y la contraseña, puedes cambiar esta información en tu archivo wp-config.php si es necesario.

Intenta volver a visitar tu sitio web para ver si el error de conexión a la base de datos se ha resuelto.

Si aún puedes ver el error, significa que algo más está causando el error. Sigue leyendo el artículo para más pasos de solución de problemas.

Verifica la información del nombre de host de tu base de datos

Si seguiste el método uno y verificaste que estás usando la información de inicio de sesión correcta de la base de datos de WordPress, debes asegurarte de estar usando la información de host de base de datos adecuada.

La mayoría de las empresas de hosting de WordPress usan "localhost" como su host de base de datos. Sin embargo, algunas empresas de hosting de WordPress usan servidores separados para alojar las bases de datos. En este caso, la información de tu host de base de datos no es localhost.

En este caso, deberás contactar a tu empresa de hosting de WordPress para obtener la información del host de tu base de datos.

Reparar las tablas de la base de datos de WordPress

Si has corregido el primer error, pero recibes otro mensaje de error, "One or more database tables are unavailable, the database may need to be repaired."

Para reparar la base de datos, añade la siguiente línea al archivo "wp-config.php":

define('WP_ALLOW_REPAIR', true);

Añade este texto directamente antes de la línea "That’s all, stop editing! Happy blogging".

Añade el código de reparación de la base de datos con la constante WP_ALLOW_REPAIR.

Visita http://www.example.com/wp-admin/maint/repair.php para ver los ajustes en esta página:

Opción Reparar y Optimizar Base de Datos

Haz clic en el botón "repair database" y espera a que termine el proceso.

Cualquier visitante puede acceder a esta página de reparación de la base de datos. Cuando hayas terminado de reparar y optimizar tu base de datos, deberás eliminar este código de tu archivo «wp-config.php».

Verifica si el servidor de base de datos está fuera de línea

Si has comprobado todos los elementos y WordPress aún no puede conectarse a la base de datos, tu servidor de base de datos (servidor MySQL) puede estar caído.

Esto ocurre cuando hay mucho tráfico en un servidor. El servidor de hosting no puede gestionar esta carga pesada. El problema se presenta especialmente cuando estás usando hosting compartido.
Como resultado, tu sitio se volverá muy lento, y algunos usuarios incluso podrían obtener el error.

Ponte en contacto con tu proveedor de hosting y mira si tu servidor MySQL está respondiendo.

Alternativamente, si tienes otros sitios web en el mismo servidor, puedes consultar esos sitios para asegurarte de que tu servidor SQL está caído.

Para comprobar si tus credenciales de acceso a la base de datos son correctas y tu servidor de base de datos no está fuera de línea, crea un nuevo archivo de texto vacío con un editor de texto, nómbralo testconnection.php y copia y pega el código siguiente en ese archivo de texto vacío:

<?php $link = mysqli_connect('localhost', 'username', 'password'); if (!$link) { die('Could not connect: ' . mysqli_error()); } echo 'Connected successfully'; mysqli_close($link); ?>

Imagen: Verifica los permisos del usuario de la base de datos
Verify if your database user has sufficient permission

Ajusta los valores "username" y "password" a tu configuración.
Ahora sube este archivo con FTP o un plugin de gestión de archivos a tu sitio web y accede a él a través de un navegador web.

Si el script puede conectarse correctamente, significa que tu usuario tiene permisos suficientes y tu servidor de base de datos está en línea. Ahora usa las mismas credenciales en el wp-config.php, y WordPress podrá conectarse a la base de datos.

En el siguiente paso, listaremos otras soluciones que también funcionan pero que ocurren con menos frecuencia que las anteriores.

Actualiza la URL del sitio WordPress

Accede a phpMyAdmin desde el panel de tu cuenta de hosting y selecciona tu base de datos de WordPress.

Luego, haz clic en el menú SQL en la parte superior e introduce la siguiente consulta MySQL:

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

Nota: Asegúrate de introducir tu propia "Site URL" y cambia "wp_options" por el nombre de la tabla de tu sitio si tu sitio usa un prefijo de tabla WordPress diferente.

Reinicia el servidor web

Si usas un servidor dedicado, un servidor local o un servidor virtual privado (VPS), puedes intentar reiniciar tus servidores.

Reiniciar los servidores web y de base de datos puede resolver problemas temporales que pueden estar causando el error.

Conclusión

El "Error Establishing a Database Connection" puede ser intimidante, pero con los pasos correctos, a menudo es una solución sencilla. Al comprender las posibles causas y aplicar las soluciones descritas anteriormente, puedes restaurar tu sitio WordPress rápidamente. El mantenimiento regular y las medidas proactivas ayudarán a prevenir este error en el futuro.

Artículos relacionados

Rene Hermenau

Autor: Rene Hermenau

Sobre el autor: René Hermenau es el fundador de WP STAGING. Trabaja en copias de seguridad de WordPress, entornos de staging, migraciones, gestión de bases de datos y flujos de despliegue seguros.