Error de conexión a base de datos en WordPress | Solución

¡Hola! Soy tu técnico de soporte amigable. Entiendo perfectamente la sensación de impotencia que se siente cuando ves ese mensaje en tu web: "Error al establecer conexión con la base de datos".

No te preocupes, no eres el único al que le ha pasado y, lo más importante, tiene solución. En la mayoría de los casos, no es un problema grave y puedes arreglarlo tú mismo en unos minutos siguiendo una serie de pasos lógicos.

En esta guía extensa, vamos a desglosar qué significa este error, por qué ocurre y, sobre todo, te daré un plan de acción claro y detallado para solucionar el error de WordPress y devolver la vida a tu sitio web.

Vamos a ello.

¿Qué significa exactamente este error?

Antes de empezar a tocar nada, es fundamental que entiendas qué te está diciendo WordPress. Imagina que tu web es una tienda física.

WordPress es el edificio (la tienda).
Los archivos de WordPress (temas, plugins, etc.) son los muebles y la mercancía.
La base de datos es el almacén trasero donde guardas el registro de todas tus ventas, tus clientes, tus productos, tus artículos del blog, etc.

El mensaje "Error al establecer conexión con la base de datos" significa que tu tienda (WordPress) está abierta y tiene los muebles colocados, pero no puede abrir la puerta del almacén. Sin acceso a ese almacén, no puede mostrar nada de lo que tiene guardado. Por eso, en lugar de mostrar tu web, muestra un mensaje de error.

Este fallo en la conexion base datos wordpress puede deberse a varias razones, desde un simple cambio de contraseña hasta un problema en el servidor. Vamos a ver cómo diagnosticarlo y arreglarlo paso a paso.

Paso 1: Comprueba si el problema es general o solo tuyo

A veces, el problema no es de tu web, sino del servidor que la aloja. Si el servidor está caído o en mantenimiento, no podrá conectar con la base de datos.

[TIP] Una forma rápida de comprobarlo es intentar acceder a la URL de tu web desde otro dispositivo (por ejemplo, desde el móvil si estabas en el ordenador) o desde otra red (como los datos móviles en lugar del WiFi).

Si el error persiste en todos los dispositivos y redes, continúa con el siguiente paso. Si solo ocurre en un dispositivo o red, el problema puede ser local (caché del navegador o DNS).

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

Este es el archivo de configuración principal de WordPress y es donde se guardan las credenciales de acceso a la base de datos. El error wp-config error es uno de los más habituales.

WordPress necesita cuatro datos para conectar con la base de datos:

DB_NAME: El nombre de tu base de datos.
DB_USER: El nombre de usuario de la base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: La dirección del servidor de la base de datos (normalmente localhost, pero a veces puede ser otro).

Cualquiera de estos datos puede haber cambiado o estar mal escrito. Esto puede pasar si has cambiado la contraseña de tu base de datos desde el panel de control de tu hosting o si alguien la ha modificado.

¿Cómo revisar y arreglar `wp-config.php`?

Accede a tu hosting: Necesitas un administrador de archivos (como el de cPanel, Plesk o Syspanel) o un cliente FTP (como FileZilla).
Localiza la carpeta raíz de tu WordPress: Normalmente se llama public_html, htdocs o el nombre de tu dominio.
Busca el archivo wp-config.php: Está en la raíz, junto a carpetas como wp-admin o wp-content.
Ábrelo con un editor de texto plano: No uses un procesador de textos como Word, sino el editor de código del panel o un programa como Notepad++.
Busca las líneas que empiezan por define('DB_ y verifica que los datos sean correctos.

// ** Configuración de MySQL ** //
define( 'DB_NAME', 'tu_nombre_de_base_de_datos' );
define( 'DB_USER', 'tu_usuario_de_base_de_datos' );
define( 'DB_PASSWORD', 'tu_contraseña_de_base_de_datos' );
define( 'DB_HOST', 'localhost' );

Corrige los datos si es necesario: Aquí es donde debes asegurarte de que todo coincide con lo que tienes en tu panel de control del hosting.

[WARNING] Ten muchísimo cuidado al editar este archivo. Un solo carácter mal puesto o un punto y coma olvidado puede romper tu web por completo. Si no estás seguro de qué cambiar, anota lo que ves y consulta con tu proveedor de hosting.

¿Dónde encuentro estos datos en mi panel de hosting?

En cPanel: Busca la sección "Bases de Datos MySQL". Ahí verás el nombre de tus bases de datos y los usuarios. Puedes cambiar la contraseña de un usuario haciendo clic en "Cambiar contraseña".
En Plesk: Ve a "Sitios web y dominios" y busca la sección "Bases de datos". Ahí puedes ver los usuarios y sus permisos.
En Syspanel (accediendo por el puerto 2106): Busca la sección de "Bases de datos". Podrás ver el nombre de la base de datos, el usuario y la opción de cambiar la contraseña.

Paso 3: Verifica el Host de la base de datos (DB_HOST)

Aunque la mayoría de las veces es localhost, no siempre es así. Algunos proveedores de hosting utilizan una dirección específica para el servidor de base de datos (por ejemplo, mysql.tudominio.com o localhost:3307).

Si has cambiado recientemente de proveedor de hosting, este dato puede haber cambiado.
Si tu web funcionaba antes y ahora no, es poco probable que el DB_HOST haya cambiado solo, pero es bueno verificarlo.

[INFO] Si tu hosting usa un panel como Syspanel, y no estás seguro de cuál es tu host de base de datos, puedes encontrarlo en la sección de "Bases de datos" del mismo panel. A menudo, si no es localhost, te lo indicarán explícitamente. Recuerda que el acceso a Syspanel es a través del puerto 2106.

Paso 4: Reparar la base de datos de WordPress

A veces, la base de datos en sí puede estar "rota" o tener tablas corruptas. WordPress tiene una función integrada para intentar repararlas.

¿Cómo activar la reparación automática?

Accede de nuevo a tu archivo wp-config.php.
Busca la línea que dice define( 'WP_DEBUG', false ); o similar.
Justo antes de la línea que dice /* ¡Eso es todo, detente de editar! Feliz blog. */, añade esta nueva línea:

define( 'WP_ALLOW_REPAIR', true );

Guarda el archivo y súbelo de nuevo al servidor.
Ahora, visita esta URL en tu navegador: https://tudominio.com/wp-admin/maint/repair.php

Verás una pantalla con dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en la primera para empezar.

IMPORTANTE: Cuando termine, borra la línea define( 'WP_ALLOW_REPAIR', true ); que añadiste y vuelve a guardar el archivo. Dejar esta línea activa es un riesgo de seguridad, ya que cualquiera podría intentar reparar tu base de datos.

Paso 5: Comprueba los límites de memoria de PHP

A veces, el error no es de conexión, sino de que WordPress se queda sin memoria para ejecutar la consulta. Esto es menos común, pero puede pasar si tu web tiene muchos plugins o es muy pesada.

¿Cómo aumentar el límite de memoria?

Abre tu archivo wp-config.php de nuevo.
Añade esta línea justo antes de la línea de "Eso es todo...":

define( 'WP_MEMORY_LIMIT', '256M' );

Guarda y sube el archivo. Esto le da a WordPress más memoria para trabajar.

[TIP] Si el problema persiste, también puedes intentar aumentar el límite de memoria de PHP en general. Esto se hace desde el panel de control de tu hosting (a menudo en la sección "PHP" o "Configuración de PHP") o editando un archivo llamado .htaccess o php.ini, pero es un paso más avanzado.

Paso 6: El problema puede ser del servidor (Hosting)

Si has llegado hasta aquí y nada funciona, es muy probable que el problema no esté en tu configuración, sino en el propio servidor.

El servidor de base de datos (MySQL/MariaDB) puede estar caído: Esto puede deberse a un fallo del sistema, un reinicio o un ataque.
El servidor puede estar sobrecargado: Si tu web recibe mucho tráfico o el servidor tiene muchos sitios, puede que la base de datos no responda a tiempo.

¿Qué hacer en este caso?

Revisa el panel de control de tu hosting: Busca notificaciones sobre mantenimiento o incidencias.
Contacta con tu proveedor de hosting: Esta es la mejor opción. Diles que tienes un "Error al establecer conexión con la base de datos" y que ya has verificado tu archivo wp-config.php. Ellos podrán revisar el estado de los servidores y ver si hay algún problema en su infraestructura.

[WARNING] No intentes reiniciar tu servidor desde el panel de control si no sabes lo que estás haciendo. Puede causar más problemas si hay otros sitios web en el mismo servidor.

Paso 7: Restaurar una copia de seguridad

Si todo lo demás falla y tienes una copia de seguridad reciente de tu web (archivos y base de datos), esta es tu solución de emergencia.

Restaura los archivos: Reemplaza todos los archivos de tu WordPress con los de la copia de seguridad.
Restaura la base de datos: Importa el archivo SQL de tu copia de seguridad en tu base de datos actual (o en una nueva).

Esto te devolverá a un estado anterior donde tu web funcionaba correctamente. Es un proceso más complejo, pero es un salvavidas.

Preguntas Frecuentes (FAQ)

¿Qué es el error "Error al establecer conexión con la base de datos"?

Es un mensaje de WordPress que indica que no puede comunicarse con el servidor donde se almacena toda la información de tu sitio (posts, páginas, comentarios, usuarios, etc.). Sin esta conexión, WordPress no puede mostrar nada.

¿Por qué veo este error en mi web de repente?

Puede ser por varias razones: un cambio reciente en la contraseña de la base de datos, un fallo en el servidor de tu hosting, un archivo wp-config.php dañado o corrupto, o incluso un ataque de fuerza bruta que ha bloqueado el acceso a la base de datos.

¿Es peligroso este error para mi sitio web?

No, en sí mismo no es peligroso. Es un error de configuración o de servidor. Tus datos no se pierden; siguen en la base de datos. Solo están inaccesibles temporalmente.

¿Puedo arreglar este error sin acceso al panel de administración de WordPress?

Sí, absolutamente. La mayoría de las soluciones implican acceder a los archivos de tu web a través del FTP o del administrador de archivos de tu hosting, no del panel de WordPress.

Si cambio la contraseña de mi base de datos, ¿tengo que actualizar `wp-config.php`?

Sí, es obligatorio. Si cambias la contraseña de la base de datos desde tu panel de control (cPanel, Plesk, Syspanel), debes actualizar la línea define('DB_PASSWORD', '...') en tu archivo wp-config.php con la nueva contraseña. De lo contrario, WordPress no podrá conectar y verás este error.

Consejos Finales para Evitar este Error

Realiza copias de seguridad periódicas: Es la mejor inversión para tu tranquilidad.
Anota los cambios que hagas en el panel de control: Si cambias contraseñas, apunta las nuevas.
Mantén WordPress, tus temas y plugins actualizados: Las actualizaciones corrigen errores y vulnerabilidades.
No edites wp-config.php sin hacer una copia de seguridad del archivo original.

Resumen: Plan de Acción Rápido

Para que no te pierdas, aquí tienes el checklist que debes seguir en orden:

Revisa si el error es general (prueba con otro dispositivo).
Verifica las credenciales en tu archivo wp-config.php (nombre, usuario, contraseña, host).
Comprueba el panel de tu hosting para ver si hay algún aviso de caída del servidor.
Utiliza la función de reparación de base de datos de WordPress.
Aumenta el límite de memoria de PHP.
Contacta con tu proveedor de hosting si nada de lo anterior funciona.
Restaura una copia de seguridad como último recurso.

Espero que esta guía te haya sido de gran ayuda. Recuerda que la mayoría de las veces, el problema se soluciona revisando el archivo wp-config.php. Si tienes más dudas, no dudes en dejar un comentario. ¡Buena suerte!