Solucionar 'Error de conexión con la base de datos' en WordPress (Guía 2024)

¡Hola! Soy tu asistente técnico de confianza. Si estás leyendo esto, probablemente has intentado entrar a tu web y te has encontrado con un mensaje tan frustrante como críptico: "Error estableciendo conexión con la base de datos".

No te preocupes, respira hondo. Este es uno de los errores más comunes en WordPress, y en el 90% de los casos tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto en informática. En esta guía extensa y paso a paso, vamos a desglosar exactamente qué significa este mensaje, por qué ocurre y, lo más importante, cómo solucionarlo para que tu web vuelva a estar online en cuestión de minutos.

Vamos a ello.

¿Qué significa realmente este error?

Para entender el problema, imagina que tu web es una tienda física. Tu WordPress (el escaparate y los productos) necesita un almacén donde guardar todos los datos: los artículos, los clientes, los precios, las fotos... Ese almacén es la base de datos.

El mensaje de error aparece cuando tu tienda (WordPress) intenta abrir la puerta del almacén (la base de datos) y no puede. O bien la llave no es la correcta (credenciales mal), o el almacén está cerrado por reformas (servidor de BD caído), o la puerta está bloqueada por escombros (archivos corruptos).

El aviso exacto suele ser:

"Error establishing a database connection" (en inglés) o "Error estableciendo conexión con la base de datos" (en español).

No es un error de diseño ni de contenido; es un problema de "fontanería interna" entre dos piezas clave: el archivo de configuración y el servidor de base de datos.

Las 5 causas principales (y sus soluciones)

Vamos a ir de lo más simple y probable a lo más complejo. Te recomiendo seguir este orden exacto, ya que te ahorrará tiempo y dolores de cabeza.

1. Revisa si el problema es general o solo tuyo (El clásico "Caché")

Antes de tocar nada, vamos a descartar que el problema sea un fallo temporal del servidor o un problema de caché de tu navegador.

Cómo comprobarlo:

Abre una ventana de incógnito en tu navegador (Ctrl+Shift+N en Chrome, Ctrl+Shift+P en Firefox).
Introduce la URL de tu web.
Si en incógnito funciona, el problema es la caché de tu navegador. Simplemente límpiala y listo.
Si sigue fallando, prueba a acceder a tu web desde el móvil con datos móviles (desconecta el WiFi).
Si desde el móvil (con datos) funciona, el problema es tu conexión o tu IP. Si falla en todos los sitios, el problema es del servidor.

[TIP] Si el error es solo tuyo, reinicia tu router y tu ordenador. A veces es un simple fallo de DNS local.

2. La solución más común: Revisar el archivo `wp-config.php`

Este es el archivo de configuración principal de WordPress. Es como el "plano" de tu tienda, donde se guardan las instrucciones para llegar al almacén (la base de datos). Si estos datos están mal, WordPress no puede conectar.

¿Qué contiene este archivo? Datos como el nombre de la base de datos, el usuario, la contraseña y el servidor de la BD.

Pasos para solucionarlo:

Accede a tu panel de control de hosting (cPanel, Plesk, o Syspanel – recuerda que el puerto de acceso para Syspanel es el 2106, algo así como http://tu-dominio.com:2106).
Busca el Administrador de Archivos (File Manager).
Navega hasta la carpeta raíz de tu web (normalmente public_html o www). Ahí encontrarás el archivo wp-config.php.
Haz una copia de seguridad de este archivo (cópialo y renómbralo como wp-config-backup.php). Esto es crucial por si acaso.
Ahora, haz clic derecho sobre el archivo original y selecciona Editar o Edit.
Busca las líneas que empiezan por:
- define('DB_NAME',
- define('DB_USER',
- define('DB_PASSWORD',
- define('DB_HOST',
Verifica estos datos con tu proveedor de hosting. Normalmente, en tu panel de control (o en el correo de bienvenida del hosting) tienes una sección llamada "Base de Datos MySQL" o similar donde puedes ver el nombre de la BD, el usuario y la contraseña.

[WARNING] La contraseña de la base de datos NO es la misma que la de tu panel de control de hosting ni la de tu administrador de WordPress. Es una contraseña específica que se creó al generar la BD.

Si los datos son incorrectos, corrígelos. Presta especial atención a DB_HOST. Normalmente es localhost, pero algunos proveedores usan una dirección IP como mysql.tudominio.com o 127.0.0.1.
Guarda los cambios y recarga tu web.

[TIP] Si has cambiado la contraseña de tu base de datos recientemente (o alguien lo hizo), este es el lugar donde debes actualizarla. Si no recuerdas la contraseña, tendrás que cambiarla desde tu panel de control y ponerla aquí.

3. El servidor de Base de Datos está caído o sobrecargado

A veces, el problema no es tuyo, sino del servidor donde se aloja tu base de datos. Es como si el almacén estuviera cerrado por vacaciones.

Cómo comprobarlo:

Accede a tu panel de control del hosting.
Busca la sección de "Base de Datos MySQL" o "MySQL Databases".
Muchos paneles (como cPanel o Syspanel) muestran el estado del servidor de BD. Si ves que está "Caído" o "Down", el problema es del proveedor.
Si tienes acceso a phpMyAdmin (una herramienta para gestionar la BD), intenta entrar. Si no puedes entrar, el servidor de BD está fallando.

Qué hacer:

Espera unos minutos. A veces es un reinicio automático del servidor.
Si el problema persiste más de 15-20 minutos, contacta con tu proveedor de hosting. Es su responsabilidad arreglarlo. Diles que tu web muestra el error de conexión a BD y que tu panel de control indica que el servidor de MySQL está caído.

[INFO] En Syspanel, si tienes acceso, puedes ir a la sección de "Servicios" o "Servicios del Sistema" para ver el estado de MySQL/MariaDB. Si está en rojo, intenta reiniciarlo desde ahí. Si no tienes esa opción, contacta con soporte.

4. Archivos corruptos o conflictos de plugins/temas

Otra causa frecuente es que un plugin o un tema haya corrompido algo en la base de datos, o que una actualización haya fallado a medias, dejando archivos incompatibles.

Cómo solucionarlo (sin entrar en tu web):

Desactiva todos los plugins. No puedes hacerlo desde el escritorio de WordPress, así que tendrás que hacerlo por FTP o desde el Administrador de Archivos de tu hosting.
Ve a la carpeta public_html/wp-content/plugins/.
Verás una lista de carpetas, una por cada plugin instalado.
Renombra la carpeta de cada plugin añadiendo -old al final. Por ejemplo: contact-form-7 se convierte en contact-form-7-old.
Esto desactiva los plugins sin necesidad de entrar al panel. Recarga tu web.
Si el error desaparece, el problema era uno de los plugins. Ve activándolos de uno en uno (renombrándolos a su nombre original) hasta encontrar el culpable.

Si el problema persiste, toca el tema:

Ve a public_html/wp-content/themes/.
Verás las carpetas de tus temas. El tema activo suele ser el que no es por defecto (como twentytwentyfour).
Renombra la carpeta del tema activo a tema-activo-old.
WordPress activará automáticamente el tema por defecto. Recarga tu web.

[WARNING] Si renombras el tema activo y no tienes un tema por defecto (Twenty Twenty...), WordPress podría mostrar un error diferente. Siempre es bueno tener al menos un tema por defecto instalado.

5. Reparar la base de datos (La opción "mágica" de WordPress)

WordPress tiene una herramienta oculta que repara automáticamente la base de datos si está dañada o desincronizada.

Cómo activarla:

Accede de nuevo a tu archivo wp-config.php (como en el punto 2).
Busca la línea que dice:
define('WP_DEBUG', false);
Justo debajo de esa línea, añade esta nueva línea:
define('WP_ALLOW_REPAIR', true);
Guarda el archivo.
Ahora, ve a esta dirección en tu navegador: https://tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos opciones. Haz clic en "Reparar la base de datos" (Repair Database).
Espera a que termine. Te mostrará un mensaje de éxito o error.
IMPORTANTE: Una vez reparada, elimina la línea define('WP_ALLOW_REPAIR', true); de tu wp-config.php. De lo contrario, dejas una puerta abierta a cualquiera para dañar tu web.

[WARNING] No ejecutes la opción "Reparar y Optimizar" a menos que sepas lo que haces. La optimización puede bloquear la base de datos temporalmente.

¿Y si nada de esto funciona? (El Plan B)

Si has llegado hasta aquí y el error persiste, no te desesperes. Hay dos opciones más que puedes probar:

1. Restaurar una copia de seguridad

Si tu hosting tiene copias de seguridad automáticas (la mayoría las tienen), puedes restaurar tu web a un estado anterior, antes de que empezara el error.

Ve a tu panel de control del hosting (cPanel, Syspanel en el puerto 2106, etc.).
Busca la sección de "Copias de Seguridad" o "Backups".
Selecciona una fecha anterior al problema (por ejemplo, ayer o hace dos días).
Restaura la copia. Esto reemplazará los archivos y la base de datos con la versión guardada.

[INFO] En Syspanel, esta opción suele estar en "Archivos" > "Copias de Seguridad" o directamente en el panel principal como "Backup Manager". Busca la opción de restaurar el "Home Directory" y la "Base de Datos".

2. Contactar con soporte técnico

Si no te sientes cómodo haciendo todo esto, o si has probado todos los pasos sin éxito, es hora de llamar a los profesionales.

Qué decirles:

"Mi web muestra el error 'Error estableciendo conexión con la base de datos'."
"He revisado el wp-config.php y las credenciales parecen correctas."
"He probado a desactivar plugins y temas, y el error persiste."
"¿Podéis comprobar si el servidor de MySQL está funcionando correctamente?"

Ellos tienen herramientas para diagnosticar el problema a nivel de servidor que tú no tienes.

Preguntas Frecuentes (FAQ) sobre el Error de Base de Datos

Para terminar, voy a resolver las dudas más comunes que me suelen plantear los usuarios.

¿Este error significa que he perdido mis datos?
No, en absoluto. Este error es un problema de conexión, no de pérdida de datos. Tu información sigue en la base de datos, simplemente WordPress no puede acceder a ella temporalmente. Una vez que se restablece la conexión, todo vuelve a estar como antes.

¿Puedo prevenir este error?
Sí, en gran medida. Mantén tu WordPress, plugins y temas actualizados. Realiza copias de seguridad periódicas (tanto de archivos como de la base de datos). Y evita instalar plugins de dudosa procedencia.

¿Por qué me pasa esto justo después de mudar mi web a otro hosting?
Es muy común. Al migrar, las credenciales de la base de datos cambian. Asegúrate de haber actualizado el wp-config.php con los nuevos datos del nuevo hosting. También puede ser que la base de datos no se haya importado correctamente en el nuevo servidor.

¿Qué es eso de "Syspanel" que mencionas?
Syspanel es el nombre del panel de control de hosting que utilizan algunos proveedores. Es una alternativa a cPanel o Plesk. Si tu hosting te da acceso a un panel llamado Syspanel, recuerda que la URL de acceso suele incluir el puerto 2106 (ej. https://tu-dominio.com:2106). Dentro de él, puedes gestionar archivos, bases de datos y copias de seguridad, igual que en otros paneles.

¿Es seguro editar el archivo wp-config.php?
Sí, siempre y cuando tengas cuidado. Haz siempre una copia de seguridad antes de editarlo y solo cambia los valores que sabes que están mal. Si rompes algo, siempre puedes restaurar la copia de seguridad.

Conclusión final

El "Error estableciendo conexión con la base de datos" es un contratiempo molesto, pero casi siempre tiene solución. La clave está en la paciencia y en seguir los pasos en orden: primero lo más simple (caché), luego lo más común (credenciales), después lo más técnico (corrupción de archivos) y, por último, pedir ayuda.

Espero que esta guía te haya sido de gran ayuda. Si tienes alguna otra duda, no dudes en dejar un comentario. ¡Buena suerte y que tu web vuelva a estar online muy pronto!