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

Actualizado September 18, 2017

“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 su sitio web ya no está comunicando o ya no tiene acceso a la base de datos y por lo tanto, su sitio web entero va hacia abajo. Esto no es algo para ser tomado a la ligera y debe tratar de resolver este problema inmediatamente, ya que esto puede afectar directamente a sus ventas, el tráfico y su analítica. Pero no se preocupe, hoy hablaremos de algunos escenarios comunes que causan este error y algunas maneras fáciles de conseguir que su 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 su sitio WordPress, como datos de publicaciones, datos de página, meta información, la configuración del plugin, información de inicio de sesión, etc. se almacena en su base de datos MySQL. Los únicos datos que no son almacenados son contenido multimedia como imágenes y sus archivos del núcleo de tema /plugin/ como index.php, wp-login.php, etc. Cuando alguien visita su 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 de su sitio, sino que también le impide acceder a su panel de WordPress.

Ejemplo de error de conexión a la base de datos

Ejemplo de error de conexión a la base de datos

Cuando el visitante intenta acceder a su sitio mientras esto sucede se generará un código de estado HTTP 500 en sus 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 al establecer una conexión a base de datos error 500

Error al establecer una conexión a base de datos error 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 se preocupe, entraremos en cada una de estas más a fondo para que pueda saber cómo solucionarlas. Normalmente puede solucionar este error en menos de 15 minutos.

  • El problema más común es que las credenciales de login de la base de datos es incorrecta. Su sitio WordPress utiliza información de login independiente para conectarse a su base de datos MySQL.
  • Su base de datos está dañada. Con tantas partes móviles con temas, plugins y usuarios eliminando e instalándolos constantemente, algunas bases de datos se corrompen. Esto puede ser debido o a una tabla corrupta o perdida, o quizá alguna información fue eliminada por accidente.
  • Usted puede tener archivos corruptos en su instalación de WordPress. Esto puede ocurrir incluso a veces debido a los hackers.
  • Problemas con el servidor de base de datos. Un número de cosas pueden estar equivocadas en el lado del web host, tales como la base de datos estando sobrecargada de un pico de tráfico o no respondiendo a demasiadas conexiones simultáneas. Esto es en realidad bastante común con los hosts compartidos ya que ellos están utilizando los mismos recursos de una gran cantidad de usuarios en los mismos servidores.

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

Antes de empezar a solucionar el error, siempre le recomendamos que realice una copia de seguridad. Muchas de las recomendaciones siguientes requieren manipular información en su base de datos, por lo que no querrá empeorar las cosas. Usted debe hacer siempre un backup antes de intentar arreglar las cosas en su sitio WordPress, no importa cuán sabio tecnológicamente crea que sea. Puede utilizar un plugin de copia de seguridad de WordPress popular como UpdraftPlus o Duplicator para realizar backups de sus archivos y base de datos.

Demasiados backups no existen, da igual lo sabio que tecnológicamente crea que sea.😉 Haga clic para Tweet

Si usted es un usuario Kinsta, simplemente puede tomar ventaja de nuestra función de backup con un solo clic. Simplemente haga clic en su sitio WordPress en MyKinsta, haga clic en “Backup” y luego en “Hacer Backup Ahora”.

Backup del sitio WordPress

Backup del sitio WordPress

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

1. Consulte Sus Credenciales de Login de la Base de Datos

La primera cosa a hacer es comprobar para asegurarse de que sus 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 su sitio WordPress se almacenan en el archivo wp-config.php que generalmente se encuentra en la raíz de su 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 su archivo wp-config.php puede conectarse a su sitio vía SFTP e ir a la raíz de su sitio web. O si está usando cPanel, puede hacer clic en “Administrador de Archivos”, vaya a la raíz de su sitio web y haga 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 debe comprobar sus valores actuales contra aquellos en su servidor para asegurarse de que sean correctos. Siga las instrucciones a continuación para 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 debe ingresar a phpMyAdmin en cPanel en la sección Bases de datos.

CPanel phpMyAdmin

CPanel phpMyAdmin

En el lado izquierdo, usted debería ver el nombre de la base de datos en la parte inferior. Puede ignorar la base de datos “information_schema” ya que esto es algo utilizado por el host. Entonces usted desea 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 usted necesitará actualizar el archivo wp-config.php.

Nombre de la base de datos de cPanel

Nombre de la base de datos de cPanel

También puede comprobar que esto sea la base de datos correcta garantizando que contiene la URL de su sitio WordPress. Para ello, simplemente haga clic en la base de datos y a continuación, haga 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 su sitio actual puede estar seguro de que usted está en el lugar correcto.

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

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

Si el nombre de la base de datos era ya correcto y si sigue recibiendo el mensaje error de conexión a la base de datos, a continuación usted también querrá comprobar su nombre de usuario y contraseña. Para ello será necesario crear un nuevo archivo PHP en el directorio raíz de su sitio WordPress e introducir el código siguiente. Puede asignarle el nombre que desee, como checkdb.php. Simplemente cambie 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: ' . mysql_error());
}
echo 'Database connection is working properly!';
mysql_close($testConnection);

A continuación, busque el archivo en el sitio WordPress: Https://yourdomain.com/checkdb.php. Si recibe un mensaje “error MySQL: Acceso denegado”, entonces usted sabrá que su nombre de usuario o la contraseña es incorrecta y se debe continuar con el siguiente paso para restablecer sus 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 hubiera visto, no estaría aquí. Asegúrese de eliminar o quitar este archivo después de que haya terminado la prueba.

Conexión a la base de datos funciona correctamente

Conexión a la base de datos funciona correctamente

Lo siguiente que necesita hacer es restablecer su nombre de usuario y contraseña. En cPanel, haga 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ácese hacia abajo y cree un nuevo usuario de MySQL. Intente 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, haga clic en “Crear usuario”. Alternativamente, también puede 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ácese hacia abajo y agregue el nuevo usuario a la base de datos. La siguiente pantalla le pedirá los privilegios que desea asignar, seleccione “Todos los privilegios”.

Agregar usuario a la base de datos en cPanel

Agregar usuario a la base de datos en cPanel

Luego tome las nuevas credenciales y actualice el archivo wp-config.php. Usted querrá actualizar los valores de DB_user y db_PASSWORD. También puede ejecutar de nuevo el archivo de prueba de antes. Esto debería resolver el problema de las credenciales. Si no, puede ser que usted todavía tenga 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 puede contactar a su proveedor de alojamiento o comprobar su documentación si no está seguro. Algunos también pueden utilizar 127.0.0.1 en lugar de localhost.

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

Verifique las Credenciales de la Base de Datos con Kinsta

¡Si usted es 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 necesita es hacer clic en la sección de información de su sitio, y hacia la parte inferior, verá 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 tome esas nuevas credenciales y actualice el archivo wp-config.php. Usted querrá actualizar los valores DB_user y db_PASSWORD. Esto debería resolver el problema de las credenciales. Si necesita restablecer estas credenciales, simplemente contacte a nuestro equipo de soporte. Si ha seguido todo lo anterior y sigue recibiendo el mismo mensaje de error de conexión a la base de datos, entonces proceda 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 ser que su base de datos se ha corrompido. Esto puede ocurrir 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 intenta ingresar a su tablero de mando de sitio WordPress y recibe 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 vea este error en el back-end, mientras que el mensaje de error de conexión a la base de datos en el frontend.

WordPress tiene en realidad un modo de reparación de la base de datos que puede iniciar. Simplemente agregue 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, vaya a la siguiente ubicación de su sitio de WordPress: Https://yourdomain.com/wp-admin/maint/repair.php. Entonces usted tendrá la opción para reparar la base de datos o reparar y optimizar la base de datos. Dado que probablemente está buscando la solución de una indisponibilidad de su sitio en el momento, le 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úrese de eliminar la línea de código que ha agregado a su archivo wp-config.php, de lo contrario cualquiera podría ejecutar la reparación. Si está ejecutando cPanel también puede 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 usted podría ejecutar una reparación dentro de phpMyAdmin. Simplemente inicie sesión en phpMyAdmin, haga clic en la base de datos y seleccione todas las tablas. Después, en el menú desplegable, haga clic en “Reparar tabla”. Esto está esencialmente sólo ejecutará el comando REPAIR TABLE.

Reparar tablas en phpMyAdmin

Reparar tablas en phpMyAdmin

Si quiere optimizar su base de datos, tenemos fantásticos tutoriales sobre cómo optimizar revisiones de WordPress por rendimiento, junto con la manera de convertir sus tablas MyISAM a InnoDB. Si usted todavía tiene problemas en su sitio, entonces, continúe con el siguiente paso en la solución de problemas.

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 su sitio o un problema con su host, rápidamente puede arreglar esto. Sin embargo, una vez más, se recomienda hacer un backup de su sitio antes de intentar esto.

Usted básicamente va a sustituir la versión básica de WordPress en su sitio. No está tocando sus plugins, temas o medios, sino sólo la instalación de WordPress. Para ello, deberá descargar una copia nueva de WordPress desde WordPress.org.

Descargar WordPress

Descargar WordPress

Descomprima este archivo en su equipo. Debe 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, suba los archivos restantes vía SFTP para su sitio, sobrescribiendo los archivos existentes. Esto reemplazará todos los archivos problemáticos y se asegurara de que tenga 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, verifique su 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 su problema, le recomendamos consultar con su 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 su sitio. Si usted es un cliente de Kinsta, no necesita 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 su 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 dashboard y disponible 24×7 si necesita ayuda. Y no olvide que tenemos representantes para atenderle tanto en inglés como en español.

Contacte al equipo de soporte de Kinsta

Contacte al equipo de soporte de Kinsta

5. Restaure la última copia de seguridad

Y por último, pero no menos importante, siempre puede 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á 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. Recuerde que usted puede ser que necesite restaurar la base de datos y sus archivos.

Si usted es usuario de Kinsta fácilmente puede restaurar un backup de su sitio web en la sección de copias de seguridad de su sitio. Simplemente elija la hora a la que desea volver a y haga clic en “Restaurar”.

Restaurar WordPress backup

Restaurar WordPress backup

A continuación, se le pedirá que confirme la restauración. Simplemente ingrese el nombre de su sitio y haga clic en “Aceptar”. También cree un backup en el momento de restaurar para que pueda deshacer la restauración si es necesario.

Confirmar restauración

Confirmar restauración

Resumen

Como puede 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 usted desea para un sitio web es experimentar tiempo de inactividad. Así que esperamos que uno de los pasos anteriores le ayuden a conseguir que su sitio esté en marcha de nuevo.

¿Ha experimentado el mensaje de error de conexión a la base de datos en su sitio? Si es así, ¿pudo resolverlo? Háganos saber en los comentarios a continuación.

Este artículo fue escrito por Brian Jackson

Brian enfoca en nuestros esfuerzos de marketing a través de las redes sociales: desde el desarrollo de la nueva estrategia de crecimiento online, creación de contenido, optimización técnica de buscadores hasta nuestra expansión en la comunidad WordPress. Es apasionado por Wordpress lleva usándolo desde hace más de 8 años e incluso está desarrollando su propio plugin exclusivo. A Brian le encanta el blogueo, películas, montar en bici y trabajar con sitios web.

Artículos relacionados

  1. Gravatar for this comment's author
    Visualmodo WordPress Themes octubre 15, 2017 at 2:20 am

    Muy bueno, tengo que enviar este artículo a algunos clientes.

Deja un comentario

kinsta newsletter

¿Utilizas WordPress?

¡Únete a más de 20.000 lectores que ya reciben nuestro newsletter semanal GRATUITO con consejos de WordPress sobre cómo generar más tráfico e ingresos para tu negocio!

You have Successfully Subscribed!

Send this to a friend