Cómo arreglar el error de conexión a la base de datos en WordPress

¡Hola! Si estás leyendo esto, seguramente te has encontrado con uno de los errores más temidos y, a la vez, más comunes del mundo WordPress: el famoso "Error al establecer la conexión con la base de datos".

No te preocupes, respira hondo. En la mayoría de los casos, este problema no significa que hayas perdido tu sitio web. Simplemente, WordPress no puede comunicarse con el lugar donde se guardan tus artículos, páginas y configuraciones (la base de datos).

En esta guía extensa y fácil de seguir, vamos a desglosar paso a paso cómo solucionar este error, tanto si usas cPanel como Plesk (o incluso Syspanel). No necesitas ser un experto en programación; solo sigue las instrucciones al pie de la letra y, en cuestión de minutos, tu web volverá a la vida.

Vamos a ello.

¿Por qué ocurre el error de conexión a la base de datos?

Antes de lanzarnos a arreglar nada, es útil entender qué significa este mensaje. Imagina que tu web es una tienda física. WordPress es el dependiente que atiende a los clientes, y la base de datos es el almacén trasero donde están todos los productos.

El error de conexión ocurre cuando el dependiente (WordPress) va al almacén (Base de datos MySQL) y no puede abrir la puerta. Las razones pueden ser varias:

Las llaves no coinciden: Las credenciales (usuario, contraseña, nombre de la base de datos) en el archivo de configuración de WordPress son incorrectas.
El almacén está cerrado: El servidor de base de datos (MySQL) está caído, sobrecargado o en mantenimiento.
La puerta ha cambiado: La dirección del servidor de base de datos (host) ha cambiado o es incorrecta.
El almacén está lleno o corrupto: La base de datos ha superado su límite de tamaño o está dañada.

A continuación, te mostramos cómo diagnosticar y solucionar cada uno de estos escenarios.

Paso 1: La solución rápida (y la más común) - Revisar el archivo wp-config.php

Este es el primer lugar donde debes mirar. El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene las "llaves" para acceder a tu base de datos.

### Cómo encontrar y editar el archivo

Accede a tu panel de control de hosting (cPanel, Plesk o Syspanel).
Busca la sección "Administrador de archivos" (File Manager).
Navega hasta la carpeta donde está instalado WordPress. Normalmente es public_html (o httpdocs en Plesk). Si tu web está en una subcarpeta (ej: public_html/miweb), entra ahí.
Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona "Editar" (o "Edit").

### Qué buscar y qué corregir

Dentro del archivo, verás líneas de código que empiezan con define. Busca estas tres líneas específicas:

define( 'DB_NAME', 'tu_nombre_de_base_de_datos' );
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );
define( 'DB_PASSWORD', 'tu_contraseña' );

DB_NAME: El nombre de tu base de datos.
DB_USER: El usuario que tiene permisos para acceder a esa base de datos.
DB_PASSWORD: La contraseña de ese usuario.

El problema más habitual: A veces, al mover un sitio o por un error humano, estos datos no coinciden con los reales.

¿Cómo saber los datos correctos? Ve a tu panel de control (cPanel o Plesk) y busca la sección de "Bases de datos MySQL". Ahí verás una lista de todas tus bases de datos y los usuarios asociados. Compara esos nombres y contraseñas con los que tienes en el archivo wp-config.php. Si no coinciden, corrígelos.

[TIP] Si no recuerdas la contraseña, puedes crear una nueva desde tu panel de control. En cPanel, entra en "Bases de datos MySQL", busca tu usuario y haz clic en "Cambiar contraseña". Luego, actualiza ese valor en el archivo wp-config.php.

Paso 2: Verificar que el servidor de base de datos está activo (MySQL)

Si las credenciales son correctas, el siguiente paso es comprobar que el "almacén" (el servidor MySQL) está abierto.

### En cPanel

Ve a la sección "Estado del Servidor" o "Información del Servidor" (a veces está en "Preferencias" o "Avanzado").
Busca en la lista si MySQL aparece con un icono verde o un check que indique que está en ejecución.
Si aparece en rojo o con una "X", el servidor está caído. No puedes hacer nada tú mismo, pero deberías contactar inmediatamente con el soporte de tu hosting para avisarles.

### En Plesk

Ve a "Herramientas y configuración" (Tools & Settings).
En la sección de "Servidor", busca "Estado del servidor" o "Servicios".
Busca el servicio "MySQL" y verifica que su estado sea "Activo" (running).

[INFO] Si el servidor MySQL está caído, lamentablemente no hay un "truco" para arreglarlo desde tu lado. Es un problema de infraestructura del servidor. La solución es contactar a tu proveedor de hosting para que lo reinicien.

Paso 3: El host de la base de datos - El factor oculto

Este es un error muy común cuando se migra un sitio web. El valor DB_HOST en tu wp-config.php no siempre es localhost.

A veces, el servidor de base de datos está en una dirección diferente, como mysql.tudominio.com o una IP específica.

¿Qué debes hacer?

Revisa tu archivo wp-config.php de nuevo. Busca esta línea:
```
define( 'DB_HOST', 'localhost' );
```
En la gran mayoría de los casos, localhost es correcto. Sin embargo, si estás en un hosting compartido o administrado, es posible que necesites cambiarlo.
¿Cómo saberlo? Revisa el correo de bienvenida de tu hosting o la documentación de tu proveedor. Si no lo encuentras, contacta con su soporte y pregunta: "¿Cuál es el host de la base de datos MySQL para mi sitio web?".

[WARNING] No cambies el valor de DB_HOST a menos que estés 100% seguro de la nueva dirección. Si pones una incorrecta, el error seguirá ahí.

Paso 4: Reparar la base de datos (Si está corrupta)

A veces, la base de datos existe y las credenciales son correctas, pero está "dañada". Esto puede pasar tras un corte de luz, una actualización fallida o un cierre inesperado. WordPress tiene una herramienta secreta para esto.

### Activar el modo de reparación

Abre tu archivo wp-config.php de nuevo.
Busca la línea que dice:
```
define( 'WP_DEBUG', false );
```
Justo encima de esa línea (o al final del archivo), añade esta nueva línea:
```
define( 'WP_ALLOW_REPAIR', true );
```
Guarda el archivo.
Ahora, ve a esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
Verás una página con dos opciones: "Reparar la base de datos" y "Reparar y optimizar la base de datos". Haz clic en la primera.
Espera a que termine. Te mostrará un mensaje de éxito o error.
MUY IMPORTANTE: Una vez terminado, elimina la línea define( 'WP_ALLOW_REPAIR', true ); que añadiste. Si la dejas, cualquiera podría acceder a esa herramienta de reparación.

Paso 5: Verificar los permisos del usuario de la base de datos

Imagina que el usuario de la base de datos tiene la llave, pero solo puede abrir la puerta delantera, no el almacén. En términos técnicos, el usuario necesita tener todos los privilegios sobre la base de datos.

### En cPanel

Ve a "Bases de datos MySQL".
En la sección "Añadir usuario a la base de datos" o "Usuarios en la base de datos", verás una lista de usuarios y sus privilegios.
Haz clic en "Administrar privilegios" (o "Manage Privileges") junto al usuario que usa tu WordPress.
Marca la casilla "TODOS LOS PRIVILEGIOS" (ALL PRIVILEGES) y haz clic en "Realizar cambios".

### En Plesk

Ve a "Bases de datos".
Haz clic en el nombre de la base de datos de tu web.
Ve a la pestaña "Usuarios".
Haz clic en el icono de edición (lápiz) junto al usuario.
Marca la casilla para darle todos los privilegios (o selecciona la opción "ALL PRIVILEGES") y guarda los cambios.

Paso 6: ¿Y si nada de esto funciona? (Syspanel y otros casos)

Si has seguido todos los pasos anteriores y el error conexión base de datos WordPress persiste, es hora de mirar más allá.

### Si usas Syspanel (HestiaCP)

Si tu hosting utiliza Syspanel (el antiguo HestiaCP), el proceso es similar, pero el acceso es diferente.

Accede a tu panel de control Syspanel a través del puerto 2106 (ej: tudominio.com:2106 o tu_ip:2106).
Busca la sección "Base de datos" en el menú lateral.
Ahí podrás ver el nombre de la base de datos, el usuario y cambiar la contraseña. Asegúrate de que los datos en tu wp-config.php coincidan exactamente con los que ves aquí.

### Contactar al soporte técnico

Si has agotado todas las opciones, es posible que haya un problema más profundo en el servidor, como un firewall bloqueando la conexión o un problema de red interna.

No te frustres. Contacta con el soporte técnico de tu hosting. Diles que ya has hecho lo siguiente:

Verificado las credenciales en wp-config.php.
Confirmado que el servidor MySQL está activo.
Reparado la base de datos.

Ellos podrán revisar los logs del servidor y encontrar el problema exacto.

Preguntas Frecuentes (FAQ) - Resolviendo dudas comunes

1. ¿Por qué veo este error después de cambiar mi contraseña de cPanel?

Es muy común. Si cambias la contraseña de tu usuario de base de datos en cPanel, debes actualizarla también en el archivo wp-config.php. Son dos cosas separadas. El panel de control y WordPress no se sincronizan automáticamente.

2. ¿Puedo perder mi contenido si hago esto?

No. Todos estos pasos están diseñados para restaurar la conexión. No borran ni modifican tus artículos, páginas o comentarios. La base de datos sigue intacta; solo estamos arreglando la forma de acceder a ella.

3. ¿Qué significa "Error al conectar con la base de datos" en lugar de "Error al establecer conexión"?

Son lo mismo. Dependiendo de la versión de WordPress o del idioma del servidor, el mensaje puede variar ligeramente, pero el significado y la solución son idénticos. Busca solucionar el problema de conectividad MySQL.

4. ¿Cada cuánto debo hacer una copia de seguridad?

¡Siempre! Es la mejor práctica. Antes de tocar cualquier archivo como wp-config.php, te recomiendo encarecidamente que hagas una copia de seguridad completa de tu sitio (archivos y base de datos). Así, si algo sale mal, puedes restaurar todo en minutos. La mayoría de los paneles de control (cPanel, Plesk, Syspanel) tienen herramientas de copia de seguridad integradas.

Resumen Final: Tu checklist para el éxito

Para que no te pierdas, aquí tienes un resumen de los pasos a seguir en orden:

Revisa el archivo wp-config.php: Verifica que DB_NAME, DB_USER y DB_PASSWORD sean correctos.
Comprueba el estado de MySQL: Asegúrate de que el servicio esté activo en cPanel, Plesk o Syspanel.
Verifica el DB_HOST: Confirma que es localhost o la dirección que te dio tu hosting.
Repara la base de datos: Usa el truco de WP_ALLOW_REPAIR si sospechas de corrupción.
Revisa los privilegios del usuario: Dale "Todos los privilegios" al usuario de la base de datos.
Contacta a soporte: Si todo lo demás falla, no insistas más y pide ayuda profesional.

Con esta guía, deberías poder arreglar error base de datos WordPress y volver a tener tu sitio en línea. Esperamos que te haya sido de gran ayuda. ¡Buena suerte!