Error al establecer una conexión con la base de datos: ¿Cómo solucionarlo?

Si has llegado hasta aquí, es porque tu web seguramente está mostrando la siguiente advertencia Error al establecer una conexión con la base de datos o Error Establishing a Database Connection (en inglés) y quieres solucionarlo cuanto antes para que todo vuelva a la normalidad, ¿verdad?

Antes de nada, me gustaría que sepas que es un error mucho más común de lo que piensas (y también algo aterrador) si tienes tu web en WordPress. El error al establecer una conexión con la base de datos significa que WordPress no puede comunicarse con MySQL y que, como consecuencia, tu sitio está caído. Da vértigo, pero ¡tiene fácil solución!

Así que para de sudar y muy atento a lo que viene a continuación. El error al establecer una conexión con la base de datos es bastante común en WordPress y puede estar causado por permisos incorrectos, bases de datos corruptas o (en muy raras ocasiones) fallos del servidor. En esta guía, te explicamos paso a paso cómo solucionar este problema y evitar que te vuelva a ocurrir.

¿Por qué se produce este error al establecer una conexión con la base de datos?

No me puedo conectar a la base de datos MySQL, ¿qué está pasando? ¿Por qué mi WordPress muestra un error al establecer una conexión con la base de datos? ¿Voy a poder solucionarlo?

Claro que tiene solución, y verás que es más sencilla de lo que piensas. Eso sí, antes de nada quiero que sepas cuáles son las causas del error al establecer una conexión con la base de datos.

Como sabes, toda la información que tienes en WordPress, desde las entradas de tu blog o la configuración de plugins o plantillas hasta los datos de inicio de sesión, se guardan en tu base de datos MySQL. Por eso, cuando un usuario accede a tu web, es necesario realizar una consulta a esa base de datos para mostrar la información que pide el usuario, pero si algo no funciona como debiera, se muestra el Error estableciendo conexión con la base de datos.

No existe una única razón por la que alguno de nuestros archivos no puede conectar con la base de datos. Así que a continuación te doy algunas de las razones por las que tu web está mostrando esta advertencia:

1. Los datos de acceso son incorrectos. Has modificado los datos de conexión a la base de datos MySQL y no son los mismos que tienes guardados en el archivo wp-config.php de WordPress. Esta situación es muy común cuando realizas una migración de un proveedor de hosting a otro. También cuando realizas una migración de tu instalación de WordPress.
2. El usuario de la base de datos no tiene permisos. Cuando realizas la instalación de WordPress de manera manual, es habitual olvidarnos de darle los permisos necesarios a la base de datos.
3. La base de datos de MySQL o MariaDB está corrupta. Puede ser que haciendo algún cambio en WordPress con plugins o plantillas, una tabla de tu base de datos se dañase o bien, que hayas eliminado información de ella por error.
4. Error del servidor MySQL o MariaDB. Si se trata de una incidencia a nivel de servidor, en este caso deberías contactar con tu proveedor de hosting web. De todas maneras, si eliges un hosting de calidad no es muy frecuente que ocurran este tipo de situaciones.

Ejemplo del error cuando WordPress no se conecta a la base de datos

Como te decía más arriba, este error impide que WordPress acceda a la base de datos MySQL, lo que deja tu sitio completamente inaccesible. Dependiendo del navegador o de la configuración del servidor, vas a ver alguna de estas variantes del mensaje:

• Error al establecer una conexión con la base de datos
• Error establishing a database connection
• MySQL server has gone away

El «Error al establecer una conexión con la base de datos» de WordPress puede parecer grave, pero si sigues los pasos que te voy a dar en la siguiente sección, vas a poder solucionarlo en solo unos minutos.

Cómo solucionar el Error al establecer una conexión con la base de datos

Antes de ponerte manos a la obra y reparar el error al establecer una conexión con la base de datos, es importante que realices una copia de seguridad de tu web. Nunca está demás tener una, sobre todo si vas a realizar cambios importantes en tu web.

Recuerda que, si tienes tu plan de Hosting WordPress o cualquier otro alojamiento web con nosotros, desde tu área de cliente tienes acceso a Premium Backup. Una herramienta que realiza dos copias de seguridad al día de todo tu contenido y que te permite realizar cualquier restauración en solo un par de clics.

Pero, ¿cómo sé cuál es el origen del problema para poder solucionarlo?

Hay algunas pistas que te pueden ayudar a saberlo como, por ejemplo, si has realizado una migración de WordPress recientemente. De todas maneras, si no sabes muy bien por dónde pueden ir los tiros, te recomendamos que sigas el siguiente orden.

1. Comprueba que los datos de acceso a la base de datos son correctos

Es una de las causas más comunes de este error al establecer una conexión con la base de datos.

Accede al archivo wp-config.php que se encuentra en el directorio raíz de WordPress y comprueba que los datos de acceso son correctos. Aquí tendrás acceso al nombre de la base de datos, usuario, contraseña y servidor.

Nombre de la base de datos
define(‘DB_NAME’, ‘nombre‘);

Usuario de la base de datos
define(‘DB_USER’, ‘usuario‘);

Contraseña de la base de datos
define(‘DB_PASSWORD’, ‘contraseña‘);

Servidor donde se encuentra la base de datos
define(‘DB_HOST’, ‘localhost‘);

Asegúrate de que los datos que se muestran ahí son correctos. Si no recuerdas estos datos (cosa que es completamente normal), simplemente accede a cPanel y, en la sección Base de Datos, pulsa sobre «Bases de datos MySQL» para comprobarlo.

Si no coinciden, edita el archivo wp-config.php y guárdalo. De esta manera, el error de conexión con la base de datos quedaría solucionado y tu web funcionando a las mil maravillas.

En cambio, si compruebas que efectivamente los datos de conexión son los correctos, pasamos al siguiente paso: el usuario de la base de datos no tiene permisos.

2. El usuario de la base de datos no tiene permisos

Puede ser otra de las causas más comunes en las que se muestra el famoso Error al establecer una conexión con la base de datos, especialmente si realizas la instalación de WordPress de manera manual.

Si has creado una base de datos en cPanel, necesitas que se conecte con, al menos, un usuario. Pero, es frecuente que, cuando creamos el usuario, no le demos los permisos necesarios para poder conectarse con la base de datos de tu instalación de WordPress.

Para que no se produzca este error, debes seguir estos pasos:

1º. Crea el usuario de la base de datos y conéctalo con la base de datos.

2º. Asígnale todos los privilegios, tal y como te mostramos en la siguiente imagen y pulsa sobre «Hacer cambios».

3. Reparar la base de datos corrupta

Como te hemos dicho, no es el caso más habitual, pero sí el más probable si tus credenciales eran correctas.

Todo, absolutamente todo lo que hagas en tu web en WordPress se guarda en la base de datos. Añadir plugins, eliminarlos, instalar una nueva plantilla… Este tipo de acciones en tu web son normales y no deberían dañarla, pero en algunos casos el hecho de añadir y eliminar tablas a tu BBDD puede corromperla. Así que, veamos cómo solucionarlo.

1º. Accede nuevamente al archivo wp-config.php, añade la siguiente línea de código y guarda los cambios.

define('WP_ALLOW_REPAIR', true);

2º. Escribe la URL de tu web en el navegador y añade el siguiente slug: /wp-admin/maint/repair.php. Es decir, debería quedarte algo como:

• www.tudominio.com/wp-admin/maint/repair.php

3º. Ahora se abrirá una nueva ventana como la que te mostramos a continuación. Desde aquí podrás reparar la base de datos seleccionando la opción que se muestra a continuación:

4º. ¡Muy importante! Una vez que hayas reparado la base de datos, vuelve al archivo wp-config.php y elimina la línea de código que añadimos al principio. En caso contrario, cualquiera podría volver a ejecutar la acción que acabamos de realizar.

¡Listo! Introduce la URL de tu web en el navegador y tu web debería estar funcionando a la perfección.

4. WordPress sigue mostrando el error al establecer una conexión con la base de datos…  ¿Qué hago?

Como te hemos comentado, es muy poco habitual que se trate de una incidencia en el servidor MySQL de tu proveedor de hosting. De todos modos, si sigues con problemas, lo mejor es que te pongas en contacto con ellos, serán los únicos que puedan solucionarlo.

¿Tienes dudas?

El «Error al establecer una conexión con la base de datos» de WordPress es uno de los problemas más comunes de este CMS, pero se puede resolver rápidamente si sigues los pasos que te he dado., desde comprobar los permisos de wp-config.php hasta reparar una base de datos corrupta (¡previa copia de seguridad, ojo!).

Para evitar que este error vuelva a darte la tabarra, tendrás que mantener la base de datos optimizada, elegir un hosting fiable y optimizado para WordPress y tratar de no usar plugins conflictivos (a veces, si tienes plugins de caché o de seguridad mal configurados, se puede bloquear la conexión a la base de datos).

¿Sigues con dudas? Déjanos un comentario y te ayudaremos. Y si tienes tu web alojada con nosotros, nuestro equipo de soporte está disponible las 24 horas.