Error 'Error establishing a database connection' WordPress | Solución

¡Vaya, qué susto! Estás navegando por tu sitio web favorito (o el tuyo propio) y, de repente, en lugar de tu contenido, aparece un mensaje en blanco o un texto que dice: "Error establishing a database connection" (Error al establecer la conexión con la base de datos). No te preocupes, es uno de los errores más comunes en WordPress y, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en programación.

Este error significa que tu sitio web no puede conectarse a la base de datos donde se almacenan todas tus publicaciones, páginas, comentarios y configuraciones. Es como si intentaras abrir la puerta de tu casa pero la llave no girara en la cerradura. Pero no cunda el pánico: vamos a arreglarlo paso a paso.

En esta guía extensa y detallada, vamos a desglosar las causas más frecuentes y te daré soluciones prácticas y claras para que tu web vuelva a funcionar en cuestión de minutos. Hablaremos de todo, desde revisar el archivo de configuración hasta contactar con tu proveedor de hosting. Así que, respira hondo y vamos a ello.

¿Por qué ocurre el "Error establishing a database connection"?

Antes de lanzarnos a resolverlo, es importante entender qué está pasando. WordPress utiliza un sistema de gestión de bases de datos llamado MySQL (o MariaDB). Para conectarse a él, necesita cuatro datos clave: el nombre de la base de datos, el usuario, la contraseña y el servidor (host). Todos estos datos se guardan en un archivo llamado wp-config.php.

Cuando ves el error establishing a database connection, significa que WordPress no puede usar esos datos para hablar con la base de datos. Las causas pueden ser varias:

Datos incorrectos en wp-config.php: Quizás alguien cambió la contraseña de la base de datos o el nombre del servidor es incorrecto.
La base de datos está caída o sobrecargada: El servidor de bases de datos (MySQL) puede estar teniendo problemas técnicos o estar saturado.
El servidor de hosting está caído: Si el servidor donde se aloja tu web está experimentando problemas, es posible que no pueda conectarse a la base de datos.
Corrupción de archivos: El archivo wp-config.php puede estar dañado o incompleto.
Problemas con plugins o temas: Aunque es menos común, un plugin mal configurado puede causar conflictos.

Vamos a abordar cada una de estas posibilidades en orden de probabilidad y facilidad de solución.

Solución Paso a Paso: De lo más simple a lo más complejo

Sigue estos pasos en orden. No te saltes ninguno, ya que el primero es el más fácil y el que más problemas resuelve.

1. Comprueba si el problema es general (¿Está caído tu hosting?)

Lo primero es lo primero: verifica que no sea un problema general del servidor. Puedes hacerlo de dos maneras:

Visita otros sitios web: Si tienes otros sitios en el mismo hosting, intenta acceder a ellos. Si también fallan, el problema es del servidor, no de tu WordPress.
Usa herramientas externas: Puedes usar sitios web como "Down For Everyone Or Just Me" para comprobar si tu web está caída para todo el mundo o solo para ti.

[TIP] Si el problema es del servidor, no hay nada que puedas hacer excepto esperar. Contacta con tu proveedor de hosting (si es Syspanel, recuerda que el acceso es a través del puerto 2106) y pregunta si hay alguna incidencia.

2. Revisa el archivo `wp-config.php` (El corazón de la conexión)

Este es el paso más común para solucionar conexion mysql wordpress. El archivo wp-config.php contiene la configuración principal de tu sitio. Necesitas revisar que los datos de la base de datos sean correctos.

¿Cómo acceder al archivo `wp-config.php`?

Tienes dos opciones: a través del administrador de archivos de tu hosting o mediante un cliente FTP (como FileZilla).

Opción A (Panel de control): Entra en el panel de control de tu hosting (cPanel, Plesk, o el panel de Syspanel). Busca el "Administrador de Archivos" o "File Manager". Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o www). Ahí encontrarás el archivo wp-config.php.
Opción B (FTP): Conecta a tu servidor usando un cliente FTP con las credenciales que te dio tu proveedor. Navega a la raíz de tu instalación de WordPress y descarga el archivo wp-config.php a tu ordenador.

¿Qué debo buscar y corregir?

Abre el archivo con un editor de texto simple (como el Bloc de notas o Sublime Text). Busca las líneas que se ven así:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );

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

/** MySQL database password */
define( 'DB_PASSWORD', 'tu_contraseña_de_base_de_datos' );

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

Verifica cuidadosamente que estos datos sean correctos:

DB_NAME: El nombre de la base de datos.
DB_USER: El usuario que tiene acceso a esa base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: El servidor donde se aloja la base de datos. Normalmente es localhost, pero a veces puede ser una dirección IP o un nombre de servidor como sql.midominio.com.

[WARNING] No cambies estos datos si no estás seguro de cuáles son los correctos. Si los modificas mal, empeorarás el problema. Si no los recuerdas, contacta con tu proveedor de hosting o busca la información en el panel de control de tu hosting (en Syspanel, dentro del puerto 2106, suele haber una sección de "Bases de Datos").

Si encuentras que los datos son incorrectos, corrígelos y guarda el archivo. Si lo has descargado por FTP, súbelo de nuevo reemplazando el original.

3. Repara la base de datos (Una solución mágica)

WordPress tiene una función oculta que puede reparar la base de datos automáticamente. Es muy fácil de activar.

Abre el archivo wp-config.php como hicimos en el paso anterior.
Busca la línea que dice:
```
define('WP_DEBUG', false);
```
(o similar).
Justo antes de esa línea (o al final del archivo, antes de la línea que dice /* That's all, stop editing! Happy publishing. */), añade esta línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo y súbelo de nuevo si es necesario.
Ahora, en tu navegador, visita esta URL: tusitio.com/wp-admin/maint/repair.php
Verás una página con dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en la primera.
Espera a que termine. Te dirá si se han corregido errores.
¡IMPORTANTE! Después de la reparación, borra la línea define('WP_ALLOW_REPAIR', true); del archivo wp-config.php. Dejar esta línea activa es un riesgo de seguridad, ya que cualquiera podría acceder a esa página.

[INFO] Esta opción es especialmente útil si el wordpress error base de datos aparece después de una importación o actualización fallida.

4. Verifica el estado del servidor MySQL (¿Está encendido?)

Si los datos de configuración son correctos y la reparación no funciona, el problema podría ser que el servidor de bases de datos (MySQL) no esté funcionando.

Si tienes un hosting compartido: No puedes hacer mucho aquí. Contacta con tu proveedor de hosting y pregunta si el servidor MySQL está operativo. Ellos podrán reiniciarlo o solucionarlo.
Si tienes un VPS o un servidor dedicado: Puedes intentar reiniciar el servicio de MySQL. Para ello, necesitas acceso SSH a tu servidor. Una vez conectado, ejecuta el siguiente comando:
```
sudo systemctl restart mysql
```
(o sudo service mysql restart en sistemas más antiguos).

[WARNING] Si no sabes qué es SSH o no te sientes cómodo con la línea de comandos, no intentes esto. Es mejor pedir ayuda a tu proveedor para no causar daños mayores.

5. Revisa si el problema es un plugin o un tema conflictivo

A veces, un plugin o un tema mal codificado puede provocar conflictos que impidan la conexión a la base de datos.

Desactiva todos los plugins: Una forma de comprobarlo es renombrando la carpeta de plugins. Accede a tu servidor por FTP o al administrador de archivos. Busca la carpeta wp-content y dentro, la carpeta plugins. Cámbiale el nombre a plugins_desactivados (o cualquier otro nombre). Esto desactivará todos los plugins a la vez. Si tu web vuelve a funcionar, el problema es uno de los plugins. Luego, ve renombrando los plugins de uno en uno para encontrar al culpable.
Cambia a un tema por defecto: De forma similar, ve a la carpeta wp-content/themes y renombra la carpeta de tu tema activo (por ejemplo, mi-tema a mi-tema_desactivado). WordPress usará automáticamente un tema por defecto (como Twenty Twenty-Four). Si tu web funciona, el problema es tu tema.

6. Comprueba los límites de conexión a la base de datos

En ocasiones, el servidor de bases de datos puede estar alcanzando su límite de conexiones simultáneas. Esto suele ocurrir en hosting compartidos si hay muchos sitios en el mismo servidor.

Solución a corto plazo: Si el error es intermitente, puede ser que el servidor esté sobrecargado. Contacta con tu proveedor y pregunta si hay algún problema de rendimiento.
Solución a largo plazo: Si tu sitio tiene mucho tráfico, considera actualizar tu plan de hosting o moverte a un VPS para tener más recursos dedicados.

7. Contacta con tu proveedor de hosting

Si has llegado hasta aquí y nada ha funcionado, es hora de pedir ayuda profesional. Contacta con el soporte técnico de tu proveedor de hosting. Diles que tienes un error establishing a database connection y que ya has revisado el archivo wp-config.php, has intentado la reparación automática y has desactivado plugins, pero el problema persiste. Ellos podrán revisar los logs del servidor y ver qué está pasando exactamente.

Preguntas Frecuentes (FAQ) sobre este error

Para cerrar, aquí tienes algunas de las preguntas más comunes que nos hacen los usuarios:

¿Puedo perder mis datos si borro el archivo `wp-config.php`?

No, el archivo wp-config.php no contiene tus publicaciones ni páginas. Solo tiene la configuración de conexión. Puedes crear uno nuevo desde cero siguiendo las instrucciones de WordPress.org. Tus datos están en la base de datos, no en este archivo.

¿Por qué el error aparece solo en algunas páginas?

Esto puede ser un síntoma de un problema de caché o de un plugin de caché que está sirviendo una versión antigua de tu sitio. Intenta limpiar la caché de tu navegador y la del plugin de caché.

¿Qué significa exactamente "DB_HOST" en `wp-config.php`?

Es la dirección del servidor donde se encuentra tu base de datos. Para la mayoría de los hosting, es localhost (es decir, el mismo servidor que tu sitio web). Pero en algunos casos, especialmente en hosting más avanzados, puede ser una dirección IP o un nombre de subdominio.

¿Es lo mismo "Error establishing a database connection" que "One or more database tables are unavailable"?

No exactamente. El primer error suele indicar que no se puede conectar con el servidor de la base de datos. El segundo error indica que la conexión se ha realizado, pero una o más tablas de tu base de datos están corruptas o no existen. Para este segundo error, la reparación automática del paso 3 es la mejor solución.

¿Cada cuánto tiempo debo hacer copias de seguridad?

¡Siempre! Es una práctica fundamental. Deberías tener copias de seguridad automáticas de tu sitio (tanto de los archivos como de la base de datos) al menos una vez por semana, o incluso a diario si actualizas contenido con frecuencia. Así, si algo sale mal, puedes restaurar tu web a un estado anterior sin perder demasiado trabajo.

Resumen y Consejos Finales

Para solucionar conexion mysql wordpress, la clave está en ir descartando posibilidades de forma metódica. Empieza por lo más sencillo (revisar el archivo wp-config.php) y ve avanzando hacia lo más complejo (revisar el servidor). En la gran mayoría de los casos, el problema se resuelve con una simple corrección en los datos de acceso a la base de datos.

Recuerda estos puntos clave:

Siempre verifica si el problema es general (hosting caído) antes de tocar nada.
Revisa que los datos en wp-config.php sean correctos (nombre, usuario, contraseña y host).
Usa la función de reparación automática de WordPress (wp-admin/maint/repair.php).
Desactiva plugins y cambia de tema para descartar conflictos.
Si todo falla, contacta con tu hosting. No tengas miedo de pedir ayuda.

Y recuerda, si tu hosting es Syspanel, el acceso a tu panel de control se realiza a través del puerto 2106. Ahí podrás encontrar herramientas para gestionar tus bases de datos, ver logs de errores y contactar con soporte.

Espero que esta guía te haya sido de gran ayuda. Con un poco de paciencia y siguiendo estos pasos, tu sitio web volverá a estar en línea en muy poco tiempo. ¡Mucha suerte!