Solucionar error de conexión a base de datos WordPress

¡Vaya! Ver el mensaje "Error al establecer conexión con la base de datos" en tu WordPress es, sin duda, un momento de pánico. Es uno de los fallos más comunes y, a la vez, más temidos, porque deja tu web completamente inaccesible, tanto para tus visitantes como para ti en el panel de administración.

Pero respira hondo. No es el fin del mundo. De hecho, en la mayoría de los casos, es un problema que puedes solucionar tú mismo en pocos minutos, sin necesidad de ser un experto en programación.

En esta guía completa y paso a paso, vamos a desglosar todas las causas posibles de este error y, lo más importante, cómo solucionarlas de forma segura y efectiva. Desde las comprobaciones más básicas hasta la intervención en archivos de configuración, te acompañaremos en todo el proceso para que tu web vuelva a la vida.

Vamos a ello.

¿Qué significa exactamente este error?

Antes de ponernos manos a la obra, es útil entender qué está pasando. WordPress es un gestor de contenidos que guarda toda tu información (artículos, páginas, comentarios, ajustes, etc.) en una base de datos, normalmente MySQL o MariaDB. Cada vez que alguien visita tu web, WordPress envía una "petición" a esa base de datos para recuperar la información y mostrarla.

Cuando ves el mensaje "Error al establecer conexión con la base de datos", significa que WordPress no ha podido comunicarse con ese "almacén de datos". Es como si intentaras abrir una puerta con la llave equivocada, o si la puerta estuviera bloqueada por dentro. Las razones pueden ser varias, y vamos a descubrirlas.

Paso 1: La comprobación rápida (y a veces mágica)

A veces, la solución es más simple de lo que pensamos. Antes de tocar nada técnico, prueba esto:

1.1. Recarga la página (Hard Refresh)

Puede sonar a tópico, pero a veces el error es temporal, quizás por un pico de tráfico o un problema momentáneo del servidor. Haz una recarga forzada de tu navegador.

En Windows/Linux: Pulsa Ctrl + F5.
En Mac: Pulsa Cmd + Shift + R.

Si la página carga, ¡fantástico! El problema era un fallo puntual. Si no, sigue leyendo.

1.2. Revisa el estado de tu proveedor de hosting

Tu web vive en un servidor que no es tuyo (a menos que tengas un servidor dedicado en casa). Es posible que tu proveedor de hosting esté teniendo problemas técnicos, mantenimiento o un ataque.

Visita la página de estado de tu proveedor (muchos tienen un sitio web dedicado a esto).
Revisa tu correo electrónico. Los buenos proveedores avisan de mantenimientos programados o incidencias.
Si no encuentras información, contacta con su soporte por teléfono o chat. Ellos te dirán si hay algún problema en sus servidores.

[INFO] Si el problema es de tu proveedor de hosting, no hay nada que puedas hacer excepto esperar a que ellos lo solucionen. No pierdas el tiempo intentando arreglar algo que no está en tu mano.

Paso 2: Las credenciales de acceso (La causa más común)

Si el hosting está bien, el siguiente paso es verificar que WordPress tiene las "llaves" correctas para abrir la base de datos. Estas llaves son un nombre de usuario, una contraseña, un nombre de base de datos y un host (normalmente localhost).

WordPress guarda esta información en un archivo llamado wp-config.php, que se encuentra en la carpeta raíz de tu instalación. Si estos datos son incorrectos, la conexión fallará.

2.1. Accede a tu panel de control (cPanel, Syspanel, etc.)

Para editar este archivo, necesitas acceder al panel de control de tu hosting, o usar un cliente FTP (como FileZilla).

Si usas cPanel: Busca la sección "Administrador de archivos" (File Manager).
Si usas Syspanel: (Recuerda que es el antiguo HestiaCP) Accede a través de tu-dominio.com:2106 con tus credenciales de administrador. Busca la opción "Administrador de archivos" o "Gestor de archivos".

2.2. Localiza y edita el archivo `wp-config.php`

Una vez dentro del administrador de archivos, navega hasta la carpeta donde está instalado WordPress (normalmente public_html o htdocs). Busca el archivo wp-config.php, haz clic derecho sobre él y selecciona "Editar" o "Edit".

Verás un archivo con código PHP. Busca las líneas que se parecen a estas (no te asustes por el código, es muy fácil de entender):

// ** Configuración de la base de datos - Puedes obtenerla de tu proveedor de hosting ** //
define( 'DB_NAME', 'tu_nombre_de_base_de_datos' );

/** Usuario de la base de datos */
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );

/** Contraseña de la base de datos */
define( 'DB_PASSWORD', 'tu_contraseña' );

/** Host de la base de datos */
define( 'DB_HOST', 'localhost' );

2.3. Verifica los datos

Ahora, compara estos datos con los que te proporcionó tu proveedor de hosting. Puedes encontrarlos en:

cPanel: En la sección "Bases de datos MySQL" o "Asistente de bases de datos MySQL".
Syspanel: Busca la sección "Bases de datos" o "MySQL". Allí verás las bases de datos que has creado y los usuarios asociados.

[WARNING] El nombre de usuario y la contraseña de la base de datos NO son los mismos que usas para entrar a tu panel de control (cPanel o Syspanel). Son credenciales diferentes, creadas específicamente para la base de datos.

Asegúrate de que:

El nombre de la base de datos (DB_NAME) es exactamente el que aparece en tu panel, incluyendo el prefijo (a menudo es usuario_nombrebd).
El usuario (DB_USER) es el correcto y está asociado a esa base de datos.
La contraseña (DB_PASSWORD) es la correcta. Es fácil equivocarse al copiarla, así que pégala con cuidado.
El host (DB_HOST) suele ser localhost, pero algunos proveedores usan mysql.tudominio.com o una IP específica. Verifícalo.

Si alguno de estos datos es incorrecto, corrígelo, guarda el archivo y recarga tu web.

Paso 3: Reparar la base de datos (WordPress tiene una función oculta)

A veces, la base de datos puede estar "corrupta" o tener tablas dañadas, lo que impide la conexión. WordPress tiene una función de reparación automática, pero está desactivada por defecto.

3.1. Activa el modo de reparación

Para activarla, necesitas añadir una línea de código a tu archivo wp-config.php (el mismo que editamos antes).

Abre el archivo wp-config.php en el editor.
Busca la línea que dice ¡Eso es todo! ¡Diviértete! o /* That's all, stop editing! Happy publishing. */.
Justo antes de esa línea, añade la siguiente línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.

3.2. Ejecuta la reparación

Ahora, en tu navegador, visita la siguiente URL (reemplaza tudominio.com con tu dominio real):

tudominio.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". Te recomendamos elegir la primera opción (Reparar base de datos).

Después de la reparación, es muy importante que elimines la línea de código que añadiste (define('WP_ALLOW_REPAIR', true);), ya que dejar esta función activa es un riesgo de seguridad.

[WARNING] No olvides eliminar la línea de código después de la reparación. Dejar WP_ALLOW_REPAIR activo permite que cualquier persona pueda intentar reparar tu base de datos, lo cual es un agujero de seguridad.

Paso 4: Problemas con el servidor (Memoria, CPU o MySQL)

Si los pasos anteriores no funcionan, el problema podría ser más profundo, relacionado con el servidor en sí.

4.1. Reinicia el servicio MySQL/MariaDB

A veces, el servicio de base de datos se bloquea o se satura. Reiniciarlo suele solucionar el problema. Esto requiere acceso al "terminal" de tu servidor.

Si tienes un VPS o servidor dedicado: Puedes hacerlo a través de SSH (acceso remoto seguro). Los comandos típicos son:
- sudo systemctl restart mysql (en sistemas con systemd, como Ubuntu 16.04+).
- sudo systemctl restart mariadb (si usas MariaDB).
- En versiones más antiguas: sudo service mysql restart.
Si tienes hosting compartido: No tendrás acceso a esto. Contacta con tu proveedor y pídeles que reinicien el servicio MySQL.

4.2. Verifica el espacio en disco y los límites de memoria

Si el disco duro del servidor está lleno, la base de datos puede fallar. También si se excede el límite de memoria PHP.

Espacio en disco: Entra a tu panel de control (cPanel o Syspanel) y verifica el uso de disco. Si está al 100%, tendrás que liberar espacio (borrar copias de seguridad antiguas, logs, etc.).
Límite de memoria PHP: Puedes intentar aumentarlo temporalmente. Añade esta línea a tu wp-config.php (justo antes de la línea de "¡Eso es todo!"):
```
define('WP_MEMORY_LIMIT', '256M');
```
Si esto lo soluciona, el problema era un límite de memoria bajo. Puedes dejar la línea o, mejor, contactar con tu hosting para que lo suban a nivel de servidor.

Paso 5: Restaurar desde una copia de seguridad

Si has llegado hasta aquí y nada funciona, es hora de considerar la restauración desde una copia de seguridad. Esta es la opción más drástica, pero también la más segura si tienes una copia reciente.

5.1. ¿Dónde tienes tus copias?

En tu hosting: cPanel y Syspanel suelen tener herramientas de copia de seguridad automáticas o manuales.
En un plugin: Si usas un plugin como UpdraftPlus o BackupBuddy, puedes tener copias en la nube (Google Drive, Dropbox) o en tu ordenador.
En tu ordenador: Si haces copias manuales con FTP, las tendrás en una carpeta local.

5.2. Restaura la base de datos

La restauración implica dos partes: los archivos de WordPress y la base de datos. Dependiendo de tu copia, puedes hacerlo de una u otra manera.

Desde el panel de control (cPanel/Syspanel): Suelen tener un asistente de restauración que te permite subir un archivo de copia de seguridad y restaurar todo automáticamente.
Manual (con phpMyAdmin): Si tienes un archivo .sql de tu base de datos, puedes importarlo desde phpMyAdmin (accesible desde cPanel o Syspanel). Este método es más avanzado, pero es la única opción si no tienes un asistente.

[INFO] Si no te sientes cómodo restaurando una copia de seguridad por tu cuenta, contacta con tu proveedor de hosting. Muchos de ellos ofrecen un servicio de restauración gratuita o de pago.

Preguntas Frecuentes (FAQ) sobre el error de conexión

Para terminar, respondemos a las preguntas más comunes que recibimos sobre este error.

¿Por qué sigo viendo el error si he cambiado la contraseña de la base de datos?

Es muy común. Cuando cambias la contraseña en tu panel de control, WordPress no se entera automáticamente. Tienes que actualizar manualmente la contraseña en el archivo wp-config.php (Paso 2 de esta guía). Si no lo haces, WordPress seguirá intentando usar la contraseña antigua.

¿Qué es "localhost" en el campo DB_HOST?

localhost es la dirección estándar que usa WordPress para conectarse a la base de datos cuando esta se encuentra en el mismo servidor que los archivos de WordPress, que es lo más habitual. Solo en configuraciones especiales (bases de datos remotas) tendrías que cambiar esto.

¿Cómo puedo evitar este error en el futuro?

Realiza copias de seguridad periódicas: Es la mejor defensa contra cualquier problema.
Actualiza WordPress, plugins y temas: Las actualizaciones corrigen errores y vulnerabilidades que pueden causar conflictos.
No instales plugins o temas de fuentes dudosas: Pueden contener código malicioso que dañe la base de datos.
Mantén un ojo en el espacio de tu disco: Llena el disco puede provocar fallos graves.

He probado todo y sigo con el error, ¿qué hago?

Si has seguido todos los pasos de esta guía y el error conexion base de datos wordpress persiste, es hora de pedir ayuda profesional. Contacta con el soporte técnico de tu proveedor de hosting. Ellos tienen acceso directo a los servidores y pueden diagnosticar problemas que están fuera de tu alcance (como fallos de hardware o configuraciones a nivel de servidor). Diles que has seguido los pasos de verificación de credenciales y reparación de base de datos para que puedan ir directamente a buscar el problema.

Esperamos que esta guía extensa te haya sido de gran ayuda para solucionar error wordpress. Recuerda que la paciencia y la lógica son tus mejores aliadas. Ve paso a paso, con calma, y casi con total seguridad, tu web volverá a estar en línea en poco tiempo. ¡Mucha suerte!