Solucionar error de conexión a base de datos en WordPress

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los errores más comunes y, a veces, alarmantes que puedes encontrar en WordPress: el temido "Error al establecer conexión con la base de datos".

No te preocupes, en la gran mayoría de los casos, la solución es sencilla y está al alcance de tu mano. Vamos a desglosar paso a paso por qué ocurre y cómo solucionarlo. Al final de esta guía, no solo habrás solucionado el problema, sino que entenderás mejor cómo funciona la conexión entre WordPress y su base de datos.

¿Qué significa exactamente este error?

Piensa en tu sitio web como una tienda física. WordPress es el encargado de montar los estantes, ordenar los productos y atender a los clientes (tus visitantes). La base de datos es el almacén donde guardas todos los productos (tus artículos, páginas, comentarios, configuraciones, etc.).

Cuando ves el mensaje "Error al establecer conexión con la base de datos", significa que tu tienda (WordPress) ha ido al almacén (la base de datos) a buscar algo, pero la puerta está cerrada, la llave no funciona o el almacén ha desaparecido. Sin acceso a ese almacén, tu tienda no puede operar.

Este error puede aparecer de repente o después de haber hecho algún cambio en tu hosting. Vamos a ver las causas más comunes y cómo solucionarlas, paso a paso.

Paso 1: Lo primero, no entres en pánico. Verifica si el problema es global

Antes de tocar nada, comprueba si el error afecta a todo el sitio o solo a una parte. A veces, es un fallo temporal del servidor.

Abre tu web en una ventana de incógnito de tu navegador. Si ves el mismo error, el problema es real.
Prueba a entrar en el panel de administración de WordPress (normalmente tudominio.com/wp-admin). Si tampoco puedes acceder, el problema es general.
Revisa si otros sitios web en tu mismo hosting funcionan. Si todos fallan, el problema es del servidor (y deberías contactar con tu proveedor de hosting). Si solo falla tu web, sigue leyendo.

[TIP] A veces, una simple recarga de la página (F5) o esperar 5 minutos soluciona un error de conexión temporal. ¡Pruébalo primero!

Paso 2: La causa más común: Credenciales incorrectas en `wp-config.php`

Este es el origen del 90% de los casos. El archivo wp-config.php es el "mapa" que le dice a WordPress dónde está el almacén y qué llave usar. Si los datos son incorrectos, no hay conexión.

¿Cómo localizar y editar `wp-config.php`?

Accede a tu hosting a través del panel de control (cPanel, Syspanel, Plesk, etc.) o mediante un cliente FTP (como FileZilla).
Navega hasta la carpeta raíz de tu instalación de WordPress. Normalmente es public_html, www o una carpeta con el nombre de tu dominio.
Busca el archivo wp-config.php. Es un archivo de texto sin formato, como un .txt.
Descárgalo a tu ordenador (por seguridad) y luego edítalo con un editor de texto plano como Bloc de Notas (Windows) o TextEdit (Mac). No uses Word o Pages, ya que pueden añadir caracteres extraños.

Busca las siguientes líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base_de_datos');
define('DB_PASSWORD', 'contraseña_de_la_base_de_datos');
define('DB_HOST', 'localhost');

¿Qué debo comprobar aquí?

DB_NAME: Debe coincidir EXACTAMENTE con el nombre de la base de datos que creaste para tu web. Un error de una letra o un guion bajo puede romper todo.
DB_USER: Debe coincidir EXACTAMENTE con el usuario que tiene permisos sobre esa base de datos.
DB_PASSWORD: Este es el error más frecuente. La contraseña debe ser la que se asignó a ese usuario. Si la cambiaste en tu panel de hosting (por ejemplo, en Syspanel o cPanel), debes actualizarla aquí también.
DB_HOST: Normalmente es localhost. Sin embargo, algunos proveedores de hosting usan direcciones diferentes (ej. mysql.tudominio.com o 127.0.0.1). Consulta con tu hosting si no estás seguro.

[WARNING] Si has cambiado la contraseña de la base de datos desde tu panel de hosting (Syspanel, etc.), NO OLVIDES actualizarla también en el archivo wp-config.php de tu web. Es uno de los errores más comunes después de un cambio de contraseña por seguridad.

¿Cómo obtener las credenciales correctas?

Si no recuerdas tus datos, puedes encontrarlos en el panel de control de tu hosting.

En Syspanel (anteriormente HestiaCP):
1. Accede a tu Syspanel a través de tudominio.com:2106 (recuerda, el puerto es el 2106).
2. Inicia sesión con tu usuario y contraseña de hosting.
3. Busca la sección "Base de datos" o "Databases".
4. Ahí verás una lista con tus bases de datos. Al lado de cada una, suele haber un botón o enlace para "Ver credenciales" o "Mostrar contraseña".

Una vez que tengas los datos correctos, guarda el archivo wp-config.php y sube la nueva versión a tu servidor, sobrescribiendo la antigua.

Paso 3: El servidor de base de datos está caído o sobrecargado

A veces, el problema no está en tu configuración, sino en el propio servidor de base de datos (MySQL/MariaDB). Esto puede ocurrir por un pico de visitas, un mantenimiento programado o un fallo del sistema.

¿Cómo saberlo?

Pregunta a tu proveedor de hosting. La mayoría tiene un estado del servicio o un chat de soporte. Si el servidor de bases de datos está caído, no hay nada que puedas hacer desde tu lado. Solo esperar a que lo solucionen.
Revisa si tu panel de control (Syspanel, cPanel) funciona. Si no puedes ni siquiera acceder a él, el problema es más grande.

[INFO] Si tu web tiene mucho tráfico y el error aparece en horas punta, puede que tu plan de hosting no sea suficiente. En ese caso, considera migrar a un plan mejor o a un hosting con recursos dedicados.

Paso 4: Problemas con la tabla de la base de datos (corrupción)

Con el tiempo, las tablas de la base de datos pueden dañarse ligeramente (sobre todo si hubo cortes de energía o errores al actualizar WordPress o plugins). Esto puede impedir la conexión.

Solución: Reparar la base de datos

WordPress tiene una herramienta oculta para esto. Solo tienes que añadir una línea a tu archivo wp-config.php.

Edita wp-config.php (como hicimos en el Paso 2).
Justo antes de la línea que dice /* ¡Eso es todo, deja de editar! Feliz blogging. */, añade esta línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo y súbelo a tu servidor.
Ahora, ve a esta URL en tu navegador (cambia tudominio.com por tu dominio real):

tudominio.com/wp-admin/maint/repair.php
Verás una página con dos opciones:
- "Reparar base de datos": Intenta arreglar los problemas.
- "Reparar y optimizar base de datos": Además de reparar, reorganiza las tablas para que funcionen más rápido. Recomiendo esta opción.
Haz clic en el botón y espera. El proceso puede tardar unos segundos o minutos.
¡Importante! Una vez terminado, vuelve a editar wp-config.php y ELIMINA la línea que añadiste. Si la dejas, cualquiera podría ejecutar esta reparación en tu web, lo cual es un riesgo de seguridad.

[WARNING] No olvides eliminar la línea define('WP_ALLOW_REPAIR', true); después de usarla. Dejarla activa es un agujero de seguridad grave.

Paso 5: El usuario de la base de datos ha perdido permisos

A veces, por error o por una migración, el usuario que utiliza tu WordPress para conectarse a la base de datos puede haber perdido los permisos necesarios.

¿Cómo solucionarlo?

Deberás acceder a la herramienta de gestión de bases de datos de tu hosting (normalmente phpMyAdmin) y reasignar los permisos.

Accede a phpMyAdmin desde tu panel de control (Syspanel, cPanel, etc.).
Selecciona tu base de datos (la que aparece en DB_NAME de tu wp-config.php).
Busca la pestaña "Privilegios" o "Usuarios".
Localiza al usuario que coincide con DB_USER.
Marca la opción "Marca todos" o "Todos los privilegios".
Haz clic en "Ejecutar" o "Aplicar".

Si no te sientes cómodo con phpMyAdmin, pide a tu proveedor de hosting que verifique los permisos. Es una gestión de 1 minuto para ellos.

FAQ: Preguntas Frecuentes sobre el Error de Base de Datos

1. ¿Este error puede borrar mi contenido?

No. El error solo impide que WordPress acceda a la base de datos para mostrar la web. Toda tu información (artículos, páginas, comentarios) sigue estando en la base de datos, intacta. Una vez solucionado el error, todo volverá a la normalidad.

2. ¿Qué hago si después de todo esto el error persiste?

Si has seguido todos los pasos y el error sigue apareciendo, el problema es más complejo y probablemente esté del lado del servidor. Contacta con el soporte técnico de tu hosting. Diles que ya has verificado las credenciales en wp-config.php, que has intentado reparar la base de datos y que el error persiste. Ellos podrán revisar los logs del servidor para encontrar la causa raíz.

3. ¿Puede un plugin o un tema causar este error?

Es muy raro, pero posible. Un plugin o tema con un error crítico de código podría, en teoría, saturar la base de datos o forzar una conexión incorrecta. Si el error empezó justo después de instalar un plugin o cambiar de tema, intenta desactivar el plugin o cambiar al tema por defecto (Twenty Twenty-Four, por ejemplo). Para hacerlo sin acceso al panel, tendrías que hacerlo desde la base de datos o mediante FTP renombrando la carpeta del plugin, pero eso ya es más avanzado.

4. ¿Y si veo el error "Una o más tablas de la base de datos no están disponibles"?

Este es una variante del mismo problema. La solución es exactamente la misma que en el Paso 4: usar la herramienta de reparación de WordPress (WP_ALLOW_REPAIR). Es muy efectiva para este caso concreto.

5. ¿Es normal que este error aparezca al migrar mi web a un nuevo hosting?

Sí, muy normal. Al migrar, las credenciales de la base de datos (nombre, usuario, contraseña, host) casi siempre cambian. El error es simplemente que tu archivo wp-config.php aún tiene los datos del hosting antiguo. Solo tienes que actualizarlo con los datos del nuevo hosting (Paso 2) y todo funcionará.

Resumen rápido: Tu checklist para solucionar el error

Respira hondo. El contenido no se pierde.
Actualiza la página por si es un fallo temporal.
Revisa wp-config.php: Verifica que DB_NAME, DB_USER, DB_PASSWORD y DB_HOST sean correctos.
Si cambiaste la contraseña en tu hosting, actualízala también en wp-config.php.
Usa la herramienta de reparación añadiendo define('WP_ALLOW_REPAIR', true); (y luego bórrala).
Contacta a tu soporte de hosting si nada funciona.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la mayoría de los problemas de conexión a la base de datos se solucionan con un simple vistazo al archivo wp-config.php. ¡No te rindas! Si tienes más dudas, aquí estoy para ayudarte.