«El error de conexión a la base de datos» es probablemente uno de los errores más comunes y aterradores que pueden encontrar los usuarios de WordPress. Es definitivamente, una estrecha vinculación con la pantalla blanca de la muerte. Este error significa que tu sitio web ya no está comunicando o ya no tiene acceso a la base de datos WordPress y por lo tanto, tu sitio web entero va hacia abajo. Esto no es algo para ser tomado a la ligera y debes tratar de resolver este problema inmediatamente, ya que esto puede afectar directamente a tus ventas, el tráfico y tu analítica.

Pero no te preocupes, hoy hablaremos de algunos escenarios comunes que causan este error y algunas maneras fáciles de conseguir que tu sitio vuelva de ser activo en corto tiempo.

¿Qué Es el Error de Conexión a la Base de Datos?

Toda la información de tu sitio WordPress, como datos de publicaciones, datos de página, informaciones meta, la configuración del plugin, información de inicio de sesión, etc. se almacena en tu base de datos MySQL. Los únicos datos que no son almacenados son contenido multimedia como imágenes y tus archivos del núcleo de tema /plugin/ como index.php, wp-login.php, etc. Cuando alguien visita tu sitio web, PHP ejecuta el código de la página y consulta la información de la base de datos, que luego se muestra al visitante en su navegador.

Si por alguna razón esto no funciona correctamente, se queda con el mensaje de error de conexión a la base de datos, como se ve a continuación. Toda la página está en blanco porque no se pueden recuperar los datos para mostrar la página, ya que la conexión no funciona correctamente. Esto no sólo rompe el frontend del sitio, sino que también impide acceder a tu panel de control de WordPress.

Sin embargo, es posible que los visitantes no vean este error en la interfaz de inmediato. Esto se debe a que es muy probable que tu sitio se siga sirviendo desde la memoria caché hasta que caduque. Por ejemplo, en Kinsta, todos los sitios de WordPress se almacenan en caché durante una hora de forma predeterminada. Por lo tanto, si un sitio todavía se está sirviendo desde la memoria caché, puede parecer activo para un visitante.

Error al establecer conexión a la base de datos en Chrome

Error al establecer conexión a la base de datos en Chrome

En Kinsta, nuestro equipo de soporte puede aumentar la duración de su caché para decir una hora o incluso una semana si lo deseas. Si tienes un sitio que no cambia muy a menudo, esto puede aumentar el rendimiento de tu sitio ya que no tiene que capturar archivos nuevos tan a menudo después de que caduque el caché. Y en casos como el anterior, el frontend del sitio en la mayoría de los casos (a no ser que tengas un script o parte de tu sitio rompiendo la caché) se mantendría mucho más tiempo.

Cuando los visitantes intenten acceder a tu sitio mientras se produce este error, generará un código de estado HTTP 500 en los registros. Este mismo código de estado aparece cuando hay un «error interno del servidor». Básicamente, significa que algo ha salido mal en el servidor y el recurso solicitado no fue entregado. Cuando todo está funcionando correctamente, el sitio generará un código de estado HTTP 200, lo que significa que todo está bien.

Error 500 al establecer conexión a la base de datos

Error 500 al establecer conexión a la base de datos

Si eres un cliente de Kinsta, también puedes consultar el informe de desglose de errores 500 en MyKinsta analytics para ver si es algo que ha sido un problema recurrente.

Desglose de errores 500

Desglose de errores 500

Escenarios Comunes que Causan este Error

Así que, ¿exactamente por qué sucede esto? Bueno, aquí están algunas razones comunes a continuación. Y no te preocupes, entraremos en cada una de estas más a fondo para que sepas cómo solucionarlas. Normalmente se soluciona este error en menos de 15 minutos.

Cómo Solucionar el Error de Conexión a la Base de Datos.

Antes de empezar a solucionar el error, siempre recomendamos realizar una copia de seguridad. Muchas de las recomendaciones siguientes requieren manipular información en tu base de datos, por lo que no querrás empeorar las cosas. Debes hacer siempre un backup antes de intentar arreglar las cosas en tu sitio WordPress, no importa cuán sabio tecnológicamente creas que eres.

Puedes utilizar un plugin de copia de seguridad de WordPress popular como UpdraftPlus o Duplicator para realizar backups de tus archivos y base de datos.

Demasiados backups no existen, da igual lo sabio que te creas tecnológicamente. 😉Click to Tweet

Si eres un usuario Kinsta, simplemente puedes tomar ventaja de nuestra función de backup con un solo clic. Simplemente haz clic en tu sitio WordPress en MyKinsta, haz clic en «Backup» y luego en “Hacer Backup Ahora».

Backup del sitio de WordPress

Backup del sitio de WordPress

Luego, también tienes la opción de restaurar una copia de seguridad de producción o staging. O puedes realizar manualmente una copia de tu base de datos MySQL usando php MyAdmin. Una vez que tengas una copia de seguridad correcta, entonces es hora de empezar a solucionar los problemas de conexión a la base de datos.

Nuestros clientes arreglan este error en minutos desde su panel de control de MyKinsta. Prueba Kinsta gratis.

1. Consulta Tus Credenciales de Login de la Base de Datos

La primera cosa a hacer es comprobar para asegurarse de que tus credenciales de login de la base de datos sean correctas. Este es por lejos la razón más común por la que el error de conexión a la base de datos ocurre. Especialmente después de que personas migren a un nuevo proveedor de hosting. Los detalles de la conexión de tu sitio WordPress se almacenan en el archivo wp-config.php que generalmente se encuentra en la raíz de tu sitio WordPress.

Contiene cuatro piezas importantes de información que necesitan ser correctas para que la conexión se realice con éxito.

Nombre de la base de datos

// ** MySQL settings ** //
/** The name of the database for WordPress */
define('DB_NAME', 'xxxxxx');

Nombre de usuario de la base de datos MySQL

/** MySQL database username */
define('DB_USER', 'xxxxxx');

Contraseña de la base de datos MySQL

/** MySQL database password */
define('DB_PASSWORD', 'xxxxxxxxx');

MySQL host (servidor)

/** MySQL hostname */
define('DB_HOST', 'localhost');

Para acceder a tu archivo wp-config.php puedes conectarte a tu sitio vía SFTP e ir a la raíz de tu sitio web. O si estás usando cPanel, puedes hacer clic en «Administrador de Archivos», ve a la raíz de tu sitio web y haz clic con el botón derecho para editar el archivo.

Administrador de archivos de cPanel

Administrador de archivos de cPanel

Aquí está un ejemplo debajo de cómo se ve el archivo al abrirlo.

Wp-config.php credenciales

Wp-config.php credenciales

Ahora tienes que comprobar tus valores actuales con los de tu servidor para asegurarte de que son correctos. Sigue las siguientes instrucciones para los usuarios de cPanel y Kinsta.

Verificar las Credenciales de la Base de Datos en cPanel

Lo primero que hay que hacer es comprobar el nombre de la base de datos. Para ello debes ingresar a phpMyAdmin en cPanel en la sección Bases de datos.

CPanel phpMyAdmin

CPanel phpMyAdmin

En el lado izquierdo, deberías ver el nombre de la base de datos en la parte inferior. Puedes ignorar la base de datos «information_schema» ya que esto es algo utilizado por el host. Entonces deseas comparar ese nombre contra el valor DB_NAME en el archivo wp-config.php. Si coinciden, entonces éste no es el problema. Si no coinciden, entonces necesitarás actualizar el archivo wp-config.php.

Nombre de la base de datos de cPanel

Nombre de la base de datos de cPanel

También puedes comprobar que esto sea la base de datos correcta garantizando que contiene la URL de tu sitio WordPress. Para ello, simplemente haz clic en la base de datos y a continuación, haz clic en la tabla wp_options (esto podría llamarse algo ligeramente diferente para fines de seguridad, como wpxx_options). En la parte superior de la tabla, verá los valores de la dirección de la URL del sitio y el nombre. Si estos coinciden con tu sitio actual puedes estar seguro de que estás en el lugar correcto.

Compruebe la dirección de la URL del sitio en el phpMyAdmin

Comprueba la dirección de la URL del sitio en el phpMyAdmin

Si el nombre de la base de datos era ya correcto y si sigues recibiendo el mensaje error de conexión a la base de datos, a continuación también querrás comprobar tu nombre de usuario y contraseña. Para ello será necesario crear un nuevo archivo PHP en el directorio raíz de tu sitio WordPress e introducir el código siguiente. Puedes asignarle el nombre que desees, como checkdb.php. Simplemente cambia los valores de db_user y db_password con aquellos que están en el archivo wp-config.php.

<?php

$test = mysql_connect('localhost', 'db_user', 'db_password');
if (!$test) {
die('MySQL Error: ' . mysqli_error());
}
echo 'Database connection is working properly!';
mysqli_close($testConnection);

A continuación, busca el archivo en el sitio WordPress: Https://yourdomain.com/checkdb.php. Si recibes un mensaje «error MySQL: Acceso denegado», entonces sabrás que el nombre de usuario o la contraseña es incorrecta y se debe continuar con el siguiente paso para restablecer los credenciales.

Acceso denegado a MySQL

Acceso denegado a MySQL

A continuación, se muestra el mensaje que querrá ver: «conexión a la base de datos está funcionando correctamente.» Pero, por supuesto, si lo hubieras visto, no estaría aquí. Asegúrate de eliminar o quitar este archivo después de que hayas terminado la prueba.

Conexión a la base de datos funciona correctamente

Conexión a la base de datos funciona correctamente

Lo siguiente que necesitas hacer es restablecer tu nombre de usuario y contraseña. En cPanel, haz clic en Bases de datos de MySQL en la sección Bases de datos.

CPanel bases de datos MySQL

CPanel bases de datos MySQL

Desplázate hacia abajo y crea un nuevo usuario de MySQL. Intenta escoger un nombre de usuario y contraseña únicos para que no se pueda adivinar fácilmente. La herramienta generador de contraseña que proporcionan ellos realmente funciona muy bien. Después, haz clic en «Crear usuario». Alternativamente, también puedes cambiar la contraseña en esta pantalla para el usuario actual de la base de datos que ya existe.

Crear nuevo usuario en MySQL

Crear nuevo usuario en MySQL

A continuación, desplázate hacia abajo y agrega el nuevo usuario a la base de datos. La siguiente pantalla te pedirá los privilegios que deseas asignar, seleccione «Todos los privilegios».

Agregar usuario a la base de datos en cPanel

Agregar usuario a la base de datos en cPanel

Luego toma las nuevas credenciales y actualiza el archivo wp-config.php. Querrás actualizar los valores de DB_user y db_PASSWORD. También puedes ejecutar de nuevo el archivo de prueba de antes. Esto debería resolver el problema de las credenciales. Si no, puede ser que todavía tengas el nombre equivocado (DB_HOST). Algunos hosts utilizan diferentes valores, vea una lista de algunos de valores comunes de la base de datos de hosts. Normalmente, esto será simplemente localhost. Pero siempre puedes contactar a tu proveedor de alojamiento o comprobar tu documentación si no estás seguro. Algunos también pueden utilizar 127.0.0.1 en lugar de localhost.

Si has seguido todo lo anterior y sigues recibiendo el mismo mensaje de error de conexión a la base de datos, entonces procede a los siguientes pasos para la resolución de problemas a continuación.

Verifica las Credenciales de la Base de Datos con Kinsta

¡Si eres un usuario Kinsta, el proceso de comprobación de las credenciales contra el archivo wp-config.php y el servidor es mucho más fácil! Todo lo que necesitas es hacer clic en la sección de información de tu sitio, y hacia la parte inferior, verás el nombre de la base de datos, nombre de usuario y contraseña de base de datos. De forma predeterminada, Kinsta usa localhost para el DB_HOST.

Credenciales de login de la base de datos de Kinsta

Credenciales de login de la base de datos de Kinsta

Luego toma esas nuevas credenciales y actualiza el archivo wp-config.php. Querrás actualizar los valores DB_user y db_PASSWORD. Esto debería resolver el problema de las credenciales. Si necesitas restablecer estas credenciales, simplemente contacta a nuestro equipo de soporte. Si has seguido todos los pasos anteriores y sigues recibiendo el mismo mensaje de error de conexión a la base de datos, entonces procede a los siguientes pasos para la resolución de problemas a continuación.

2. Reparar una Base de Datos Corrupta

En algunos casos, podría ocurrir que tu base de datos se ha corrompido. Esto puede pasar ocasionalmente (aunque no muy a menudo) ya que a lo largo del tiempo cientos de tablas están siendo constantemente agregadas/eliminadas por nuevos plugins y temas. Si intentas ingresar a tu panel de control del sitio WordPress y recibes el siguiente mensaje de error, significa que la base de datos está dañada: «Una o más tablas de la base de datos no están disponibles. La base de datos puede debe ser reparado». Es importante señalar que es posible que sólo veas este error en el back-end, mientras que el mensaje de error de conexión a la base de datos en el frontend.

Nuestros clientes arreglan este error en minutos desde su panel de control de MyKinsta. Prueba Kinsta gratis.

WordPress tiene en realidad un modo de reparación de la base de datos que puedes iniciar. Simplemente agrega lo siguiente al final del archivo wp-config.php.

define('WP_ALLOW_REPAIR', true);
Modo de reparación de WordPress

Modo de reparación de WordPress

A continuación, ve a la siguiente ubicación de tu sitio de WordPress: Https://yourdomain.com/wp-admin/maint/repair.php. Entonces tendrás la opción para reparar la base de datos o reparar y optimizar la base de datos. Dado que probablemente estás buscando la solución de una indisponibilidad de tu sitio en el momento, te recomendamos ir con la opción de reparación de base de datos, pues es más rápida.

Reparar base de datos de WordPress

Reparar base de datos de WordPress

Después de ejecutar la reparación de la base de datos anterior, asegúrate de eliminar la línea de código que has agregado a tu archivo wp-config.php, de lo contrario cualquiera podría ejecutar la reparación. Si estás ejecutando cPanel también puedes ejecutar una reparación dentro de la pantalla de bases de datos MySQL.

Base de datos de reparación de cPanel

Base de datos de reparación de cPanel

O podrías ejecutar una reparación dentro de phpMyAdmin. Simplemente inicia sesión en phpMyAdmin, haz clic en la base de datos y selecciona todas las tablas. Después, en el menú desplegable, haz clic en «Reparar tabla». Esto está esencialmente sólo ejecutará el comando REPAIR TABLE.

Reparar tablas en phpMyAdmin

Reparar tablas en phpMyAdmin

Y finalmente, tu otra opción sería ejecutar la reparación usando WP-CLI con el siguiente comando:

wp db repair

Revisa más documentación sobre el uso en los recursos del desarrollador de WordPress

Si quieres optimizar tu base de datos, tenemos fantásticos tutoriales sobre cómo optimizar revisiones de WordPress por rendimiento, junto con la manera de convertir tus tablas MyISAM a InnoDB. Si todavía tienes problemas en tu sitio, entonces, continua con el siguiente paso en la solución de problemas.

Lectura sugerida: ¿Cómo Corregir el Error «MySQL Server Has Gone Away» en WordPress?

3. Arreglando Archivos Corruptos

La próxima razón posible por la que debe estar viendo el mensaje de error de conexión a la base de datos es que los archivos se han vuelto corruptos. Si esto se originó de un problema con la transferencia de archivos a través de FTP, o un hacker obtuvo acceso a tu sitio o un problema con tu host, rápidamente puede arreglar esto. Sin embargo, una vez más, se recomienda hacer un backup de tu sitio antes de intentar esto.

Básicamente vas a sustituir la versión núcleo de WordPress en tu sitio. No estás tocando tus plugins, temas o medios, sino sólo la instalación de WordPress. Para ello, deberás descargar una copia nueva de WordPress desde WordPress.org.

Descargar WordPress

Descargar WordPress

Descomprime este archivo en tu equipo. Debes eliminar la carpeta wp-content, así como el archivo wp-config-sample.php.

Eliminar la carpeta wp-content

Eliminar la carpeta wp-content

A continuación, sube los archivos restantes vía SFTP para tu sitio, sobrescribiendo los archivos existentes. Esto reemplazará todos los archivos problemáticos y te asegurara de que tengas otros nuevos que estén limpios y no estén dañados. Se recomienda borrar la cache del navegador después de hacer esto. Luego, verifica tu sitio WordPress para ver si el error persiste.

4. Problemas con el Servidor de la Base de Datos

Si nada de lo anterior ha ayudado a resolver tu problema, te recomendamos consultar con tu proveedor de servicios de hosting, ya que podría ser un problema con el servidor de base de datos. Por ejemplo, si hay demasiadas conexiones simultáneas a la base de datos a la vez, podría generar el error. Esto es debido a que una gran cantidad de hosts tienen límites en sus servidores de cuántas conexiones se permiten a la vez. Utilizar un plugin de cache puede ayudar a minimizar las interacciones de bases de datos en tu sitio. Si eres un cliente de Kinsta, no necesitas cache plugins ya que tenemos cache a nivel de servidor rápida en marcha.

Este problema puede ocurrir mucho en alojamientos compartidos ya que alguien teóricamente podría estar afectando tu sitio. Esto es debido a que muchos hosts comparten los mismos recursos en los servidores. Esta es otra razón por la que siempre recomendamos ir con un WordPress hosting gestionado de alto rendimiento , para que las cosas no estén abarrotadas. También significa que el entorno es típicamente afinado para manejar grandes cantidades de tráfico específicamente a sitios WordPress.

El equipo de soporte conocedor de Kinsta siempre está a un clic en la parte inferior a la derecha en el panel de control y disponible 24/7 si necesitas ayuda. Y no olvides que tenemos representantes para atenderte tanto en inglés como en español.

Contacte al equipo de soporte de Kinsta

Contacta al equipo de soporte de Kinsta

5. Restaura la última copia de seguridad

Y por último, pero no menos importante, siempre puedes recurrir a una copia de seguridad si es necesario. En algunos casos, esto podría ser una manera más rápida para resolver el problema si no estás preocupado por la posibilidad de perder todos los datos entre el momento que el último backup fue hecho. Muchos hosts tienen su propio proceso de restauración de copia de seguridad. Recuerda puede ser que necesites restaurar la base de datos y tus archivos.

Si eres usuario de Kinsta fácilmente puede restaurar un backup de tu sitio web en la sección de copias de seguridad de tu sitio. Simplemente elige la hora a la que deseas volver a y haz clic en «Restaurar». Luego puedes seleccionar si deseas restaurar a Staging o sitio en producción.

Restaurar WordPress backup

Restaurar WordPress backup

A continuación, se te pedirá que confirmes la restauración. Simplemente ingresa el nombre de tu sitio y haz clic en «Aceptar». También crea un backup en el momento de restaurar para que puedas deshacer la restauración si es necesario.

Confirmar restauración

Confirmar restauración

Resumen

Como puedes ver, existen bastantes maneras de corregir el error de conexión a la base de datos de WordPress. Las más comunes son las credenciales no válidas en el archivo wp-config.php. Verificar que esas sean correctas es el mejor lugar para empezar. La última cosa que deseas para un sitio web es experimentar tiempo de inactividad. Así que esperamos que uno de los pasos anteriores te ayudan a conseguir que tu sitio esté en marcha de nuevo. Recuerda, siempre puedes restaurar tu sitio de un backup si es necesario.

¿Has experimentado el mensaje de error de conexión a la base de datos en tu sitio? Si es así, ¿has podido resolverlo? Haznoslo saber en los comentarios a continuación.


If you enjoyed this article, then you’ll love Kinsta’s WordPress hosting platform. Turbocharge your website and get 24/7 support from our veteran WordPress team. Our Google Cloud powered infrastructure focuses on scalability, performance, and security. Let us show you the Kinsta difference! Conozca nuestros planes