Cómo solucionar "Error al establecer una conexión de base de datos"

Oh, el temido "Error al establecer una conexión de base de datos", dum, dum, dum (imagínese la reproducción de música siniestra). Si es un diseñador o desarrollador experimentado de WordPress, lo más probable es que pueda corregir este error. Pero para aquellos de ustedes que son nuevos en WordPress, este puede ser un mensaje de error aterrador.

Es posible que vea este error cuando intente instalar WordPress manualmente o verá este error en una fuente negra grande en una pantalla blanca en su navegador cuando intente acceder a su sitio web o entorno de desarrollo local. Esta última es la versión más aterradora de este error porque normalmente te pilla desprevenido.

Por supuesto, cualquier host de WordPress bien administrado debe configurar todo para usted y asegurarse de que nunca surjan estos errores. Pero si está utilizando un host de WordPress que lo hace instalar y administrar WordPress usted mismo, o si está desarrollando en su computadora local, es posible que tenga este problema.

De todos los archivos PHP de WordPress necesarios para ejecutar WordPress, wp-config.php es el más importante porque sin ese archivo, su sitio no puede conectarse a su base de datos y su sitio no funcionará. Este archivo es donde define la información de conexión de su base de datos, como el nombre de la base de datos, el nombre de usuario, la contraseña y el host. En hosts como Flywheel, en realidad no puede editar este archivo, ya que está configurado para usted. Puede omitir con seguridad esta siguiente razón si está utilizando un host administrado.

La razón más común de este error

La razón más común por la que aparece el infame "Error al establecer una conexión a la base de datos" se debe a una configuración incorrecta de la conexión a la base de datos en wp-config.php . Al mover un sitio de una antigua empresa de alojamiento, debe asegurarse de actualizar el Nombre de la base de datos, el Nombre de usuario de la base de datos y la Contraseña de la base de datos en su archivo wp-config.php para reflejar la nueva base de datos en su nuevo alojamiento.

Mover incorrectamente su sitio de WordPress

Un problema común que he visto es cuando alguien mueve sus archivos de WordPress a una nueva empresa de hospedaje y luego apunta el nombre de dominio al nuevo hospedaje, pero no movieron su base de datos.

Haz que tu sitio sea ultrarrápido: Parte 2

La semana pasada, hablé sobre cómo acelerar su sitio con un enfoque en el rendimiento del front-end. Y si bien eso puede ser extremadamente útil para acelerar su sitio, no olvide que está la parte de atrás...

El sitio seguirá apareciendo cuando vaya a la URL y seguirá funcionando. El problema aquí es que cuando finalmente cancela su alojamiento anterior, el sitio web dejará de funcionar porque se estaba conectando a la base de datos en la cuenta de alojamiento anterior, lo que produce el mensaje de error "Error al establecer una conexión de base de datos".

La mejor práctica es mover todo a su nueva empresa de alojamiento y actualizar su archivo wp-config.php para reflejar la nueva base de datos. De esa manera, puede cancelar con confianza su antigua cuenta de alojamiento sin perder ningún dato y ver el temido error "Error al establecer una conexión de base de datos".

Si está en Flywheel, simplemente moverán todo por usted y se asegurarán de que esté en funcionamiento, eliminando la molestia de tener que descubrir cualquiera de estas configuraciones.

Su archivo wp-config.php es el primer lugar donde debe comenzar cuando intente solucionar este problema. Si verifica que la información de su conexión es correcta, pase a estas otras correcciones que se describen a continuación.

Puede haber una variedad de razones por las que ocurre este error y lo guiaré a través de algunos escenarios adicionales. No se preocupe, no necesita ser un mago desarrollador para corregir este error.

Antes de probar cualquiera de estas correcciones a continuación, asegúrese de crear una copia de seguridad de su base de datos. Puede hacer esto a través de su panel de control de hosting yendo a phpMyAdmin y luego exportando el archivo SQL.

Vamos a sumergirnos, ¿de acuerdo?

Causa 1. Olvidó actualizar su archivo wp-config.php cuando cambió la contraseña de la base de datos

Actualizar la contraseña de una base de datos para que su base de datos sea más segura es algo realmente bueno. Una contraseña segura es el mejor tipo de contraseña. Recuerda que cuando cambias la contraseña de una base de datos en el panel de control de tu hosting, también necesitas cambiar la contraseña en tu archivo wp-config.php .

La buena noticia es que esta es una solución fácil. Todo lo que tiene que hacer es abrir su archivo wp-config.php y agregar la nueva contraseña.

Descarga tu archivo wp-config.php , abre un editor de texto y edita la siguiente línea:

define('DB_PASSWORD', 'password-goes-here');

Agregue su nueva contraseña, guarde el archivo wp-config.php y cárguelo a través de FTP. Actualice su sitio y vea si su sitio vuelve. Si es así, ya está. ¡Felicitaciones, has ganado todos los puntos de Internet!

Nota: asegúrese de dejar las comillas simples alrededor de la contraseña, y tampoco debe haber espacios entre las comillas simples y su contraseña.

¿Fácil, verdad?

Esencialmente, lo que está haciendo es asegurarse de que la información de conexión de su base de datos esté actualizada para reflejar la nueva contraseña de la base de datos.

Una vez más, si está en un host como Flywheel, este paso no se aplica a usted y puede continuar con seguridad.

Causa 2. Ingresaste la información de tu base de datos incorrectamente durante la famosa “instalación de 5 minutos” de WordPress

Los errores tipográficos son literalmente la ruina de nuestra existencia cuando trabajamos en línea; un pequeño error tipográfico puede colapsar un sitio web y, en este caso, un guión bajo incorrecto u olvidar una letra o un número del nombre de la base de datos, el nombre de usuario o la contraseña tiene el mismo efecto de bloqueo.

La mayoría de las instalaciones de WordPress se manejan a través de su panel de control de alojamiento utilizando un asistente en estos días, o se realizan completamente para usted en Managed WordPress. Pero a algunas personas les gusta instalar manualmente. Escuché que las instalaciones manuales todavía existen.

Si eligió instalar WordPress a la manera Ye Olde Fashioned creando manualmente una base de datos y cargando manualmente el software de WordPress a través de FTP, debe asegurarse de guardar la información del usuario de la base de datos cuando creó su base de datos. Aquí es donde copiar y pegar realmente resulta útil.

Sin embargo, asegúrese de que al copiar esta información, solo copie el texto que necesita. ¿Sabía que copiar un espacio en blanco adicional después del nombre de la base de datos, el nombre de usuario o la contraseña se leerá como un carácter? Este carácter en blanco adicional le dará errores cuando el instalador intente conectarse a su base de datos.

Además, asegúrese de ingresar la información en el campo adecuado durante la instalación. De hecho, una vez tuve un pedo cerebral y me di cuenta de que estaba ingresando el nombre de la base de datos en el campo incorrecto. Una vez reparado, ¡la instalación se realizó sin problemas!

Causa 3. Al mover un sitio web de WordPress a un nuevo host, DB_HOST puede ser algo exclusivo de ese host

Aunque actualizó su archivo wp-config.php para reflejar la nueva información de conexión de la base de datos en su nueva empresa de alojamiento, es posible que deba cambiar su campo DB_HOST .

Este problema es más raro, pero sucede. Algunas empresas de alojamiento usan sus propios valores únicos al definir el parámetro DB_Host en wp-config , pero no siempre es así. Otros hosts en realidad definen una URL para el servidor de la base de datos MySQL y eso debe reflejarse como el valor de DB_HOST . Algunos usuarios también han tenido éxito al usar su dirección IP de alojamiento en lugar de una URL de MySQL o localhost, por lo que también puede intentarlo.

Si está en Flywheel, esto se maneja automáticamente por usted, por lo que no tiene que preocuparse en absoluto.

Causa 4. Su base de datos se corrompe

Este error no es lo mismo que "Error al establecer una conexión con la base de datos", pero está ligeramente relacionado. A veces, el front-end de su sitio web funciona bien, pero obtiene un error como "Una o más tablas de la base de datos no están disponibles, es posible que la base de datos deba repararse" en el backend. Esto significa que debe reparar la base de datos.

Aquí está la solución para este error:

Abra su archivo wp-config.php y vaya a la sección que define el nombre de su base de datos, nombre de usuario, contraseña y host. En Host, defina lo siguiente:

define('WP_ALLOW_REPAIR', true);

Luego guarde su archivo wp-config.php , cárguelo a través de FTP y luego vaya a esta URL:

Esto abrirá una página con dos opciones. La primera opción es un botón que dice "Reparar base de datos" y la segunda opción es un botón que dice "Reparar y optimizar base de datos".

Tengo que reiterar la importancia de hacer una copia de seguridad de su base de datos antes de realizar este paso. Aunque no pueda conectarse, no significa que no deba tener una copia de seguridad.

Haga clic en la opción "Reparar base de datos" y una vez que finalice el proceso de reparación, abra una nueva pestaña y vaya a su URL y vea si el mensaje "Error al establecer una conexión de base de datos" desapareció y si su sitio volvió a la normalidad.

Si esta solución no funciona y las soluciones anteriores no funcionan, hay una última causa que debe conocer.

La mayoría de los hosts administrados realizarán una copia de seguridad de sus datos diariamente, por lo que si ocurre este escenario no tan bueno, a veces es más fácil restaurar desde la copia de seguridad de ayer y seguir avanzando.

Causa 5. El servidor de la base de datos MySQL está inactivo.

Esto tiende a suceder para las personas que están llevando su alojamiento compartido al límite. Si su sitio web recibe mucho tráfico, esto simplemente puede abrumar al servidor de la base de datos. Choca esos cinco con usted por tener un sitio web que recibe todo ese tráfico dulce, pero si recibe el mensaje "Error al establecer una conexión de base de datos" y ha probado las otras soluciones, es posible que deba actualizar.

En un host compartido, se pueden abarrotar toneladas de sitios web en el mismo servidor. Si uno recibe mucho tráfico o simplemente es un vecino ruidoso en general, puede causar un gran problema para el resto de los sitios. En hosts administrados como Flywheel, cada sitio tiene su propio servidor, por lo que este problema se maneja fácilmente.

Pero antes de saltar directamente a una actualización de alojamiento, debe llamar a su empresa de alojamiento y pedirles que verifiquen el estado del servidor de la base de datos. Tal vez haya un problema técnico, o tal vez su empresa de alojamiento le envió un correo electrónico sobre el mantenimiento programado del servidor y se lo perdió. Si bien es muy poco probable que vea el mensaje "Error al establecer una conexión de base de datos" como resultado del mantenimiento del servidor, lo he visto una vez en mi carrera y, de cualquier manera, vale la pena llamar por teléfono para averiguarlo.

Hable con su empresa de alojamiento y explíqueles que probó estas diversas correcciones sin éxito y pídales que lo investiguen. Si le dicen que su sitio está produciendo una gran carga en el servidor y le recomiendan una actualización de alojamiento, ¡felicitaciones, es increíble! ¡Recuerde que estas actualizaciones significan que su sitio está pateando traseros!

La recapitulación

Como puede ver, corregir el error "Error al establecer la conexión de la base de datos" no es tan aterrador como pensaba. Solo se necesita un poco de diligencia debida para verificar que está definiendo la configuración adecuada de la base de datos en su archivo wp-config.php . En algunos casos, se necesita una investigación más profunda para resolver el problema. Y al final del día, su empresa de alojamiento está allí para respaldarlo.

Más información sobre el volante

Sea cual sea su entorno de trabajo, la potente plataforma de WordPress de Flywheel elimina todas las molestias del alojamiento, agiliza sus procesos y le permite volver a hacer su mejor trabajo.

Aprende más aquí.