Solucionar Error de Conexión a Base de Datos en WordPress

¡Hola! Soy tu técnico de soporte de confianza.

Si has llegado hasta aquí es porque, muy probablemente, te has encontrado con un mensaje que hiela la sangre a cualquier persona que tiene una web: "Error estableciendo conexión con la base de datos".

No te preocupes. Respira hondo. Este es uno de los errores más comunes en el mundo de WordPress y, en la gran mayoría de los casos, tiene una solución sencilla que no requiere que seas un experto en informática. En esta guía extensa y paso a paso, vamos a desglosar qué significa este error wordpress base de datos, por qué ocurre y, lo más importante, cómo solucionarlo sin perder los nervios (ni tu web).

Vamos a ello.

¿Qué significa exactamente este error?

Para entenderlo, imagina que tu web es una tienda física. El "escaparate" (tu sitio web) necesita acceso al "almacén" (la base de datos) para mostrar los productos (tus entradas, páginas y comentarios). El mensaje de error significa que tu tienda (WordPress) no puede abrir la puerta del almacén.

En términos técnicos, WordPress no ha podido conectarse al servidor de base de datos (normalmente MySQL o MariaDB). Esto puede deberse a que la "llave" (las credenciales) es incorrecta, la "cerradura" (el servidor) está rota, o el "camino al almacén" (el host) ha cambiado.

La conexión base de datos wordpress falla por una de estas cuatro razones principales:

Datos de acceso incorrectos (usuario, contraseña, nombre de la base de datos).
El servidor de base de datos está caído o sobrecargado.
Archivos corruptos en el núcleo de WordPress.
Problemas con la IP del servidor (muy común en hosting compartido).

Vamos a atacar cada una de estas causas desde la más simple a la más compleja.

Antes de empezar: Haz una copia de seguridad (¡Importante!)

[WARNING] Este proceso implica modificar archivos sensibles de tu instalación. Aunque es seguro si sigues los pasos, es obligatorio que hagas una copia de seguridad de tu archivo wp-config.php antes de tocarlo. Si algo sale mal, podrás revertir el cambio fácilmente.

Puedes acceder a tu hosting mediante FTP (con programas como FileZilla) o a través del administrador de archivos de tu panel de control (cPanel, Syspanel, etc.). Localiza la carpeta raíz de tu WordPress (normalmente public_html) y descarga el archivo wp-config.php a tu ordenador. Ya tienes tu red de seguridad.

Paso 1: Verifica tus credenciales en el archivo wp-config.php

En más del 70% de los casos, el problema es un simple error tipográfico o un cambio de contraseña mal sincronizado. Vamos a revisar la "llave".

¿Cómo encontrar el archivo?

Accede a tu hosting por FTP o por el administrador de archivos. Busca el archivo llamado wp-config.php en la raíz de tu sitio. Ábrelo con un editor de texto plano (como el Bloc de notas o Sublime Text).

¿Qué tengo que buscar?

Dentro del archivo, busca las líneas que empiezan por DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. Deben verse así:

// ** Ajustes de MySQL ** //
define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );

¿Cómo solucionarlo?

Comprueba los nombres: Asegúrate de que DB_NAME y DB_USER son exactamente los que ves en tu panel de control (por ejemplo, Syspanel o cPanel). A veces tienen prefijos como usuario_wpdb. Un simple error de mayúsculas o un carácter de más impedirá la conexión.
La contraseña: La DB_PASSWORD debe coincidir exactamente con la que configuraste. Si la cambiaste recientemente desde el panel de tu hosting, es muy probable que el archivo wp-config.php siga teniendo la antigua.
El host: El valor más común es localhost. Sin embargo, algunos proveedores de hosting utilizan una dirección específica como mysql.tudominio.com. Verifica esta información en el correo de bienvenida de tu hosting o en la sección de "Bases de datos" de tu panel.

Si has cambiado algo, guarda el archivo y súbelo de nuevo (si lo editaste localmente). Intenta recargar tu web.

[TIP] Si no recuerdas tu contraseña de la base de datos, puedes cambiarla desde tu panel de control (por ejemplo, en Syspanel, busca la sección de Bases de Datos o MySQL). Una vez cambiada, actualiza el archivo wp-config.php con la nueva.

Paso 2: Reinicia y verifica el estado del servidor de base de datos

A veces, el problema no eres tú, es el servidor. Si tus credenciales son correctas y el error persiste, es hora de mirar el "almacén".

El servidor está caído o sobrecargado

Los servidores de bases de datos pueden colapsar por un exceso de tráfico o un fallo interno. Esto es especialmente común en hosting compartido, donde un "vecino" con una web muy pesada puede saturar el sistema.

¿Cómo lo compruebo?

Accede a tu panel de control: Entra en tu panel de hosting (Syspanel, cPanel, Plesk). Busca una sección llamada "Estado del Servidor", "Monitor" o similar.
Revisa el estado de MySQL: Deberías ver una lista de servicios. Busca "MySQL" o "MariaDB". Si está en rojo o dice "Detenido", el problema es ese.
Reinicia el servicio: En la mayoría de los paneles, tendrás un botón para "Reiniciar" o "Iniciar" el servicio. Haz clic en él.

¿Y si no puedo reiniciarlo?

Si no tienes opción de reiniciar (porque tu plan de hosting no lo permite), contacta con el soporte de tu proveedor. Diles que tienes un wordpress troubleshooting y que tu sitio muestra el error de conexión a la base de datos. Ellos podrán reiniciar el servicio por ti o decirte si hay una incidencia general.

[INFO] En Syspanel (que accedes por el puerto 2106), esta opción suele estar en "Servicios" o "Daemons". Si no la ves, su soporte técnico te ayudará encantado.

Paso 3: Reparar archivos corruptos de WordPress

Si las credenciales están bien y el servidor funciona, el problema puede ser que un archivo de la instalación de WordPress se haya corrompido (por ejemplo, una actualización fallida o un ataque malicioso). Es como si una pieza del escaparate estuviera rota.

La solución: Reemplazar el núcleo de WordPress

No te asustes, no perderás tu contenido (entradas, páginas, comentarios) porque eso vive en la base de datos. Solo vamos a reemplazar los archivos del "motor" de WordPress.

Descarga WordPress: Ve a es.wordpress.org y descarga la última versión de WordPress en tu ordenador.
Descomprime el archivo: Extrae el contenido del ZIP. Verás una carpeta llamada wordpress.
Conéctate por FTP: Usa FileZilla o el administrador de archivos de tu hosting.
Sustituye los archivos: Entra en la carpeta wordpress que descargaste y sube TODO su contenido a la raíz de tu sitio web (donde tienes instalado WordPress).
- [WARNING] Cuando te pregunte si quieres "Reemplazar" o "Sobrescribir" los archivos existentes, elige SÍ. No borres nada manualmente, solo deja que se sobrescriban.
- IMPORTANTE: No borres la carpeta wp-content que ya tienes en tu servidor. Esa contiene tus temas y plugins. Al sobrescribir, solo se actualizarán los archivos del núcleo, no tus datos.

Una vez subido, recarga tu web. Este proceso suele arreglar el error si era causado por un archivo corrupto.

Paso 4: El problema de la IP del servidor (Hosting Compartido)

Este es un clásico. En muchos servidores de hosting compartido, la base de datos está configurada para aceptar conexiones solo desde ciertas IPs. Si tu proveedor ha cambiado la IP de tu sitio web (algo que ocurre a menudo), la conexión fallará.

¿Cómo se soluciona?

Revisa tu panel de control: Busca la sección de "Bases de datos MySQL".
Busca "Host Remoto" o "IP de Acceso": Normalmente hay un campo para añadir IPs que pueden conectarse a la base de datos.
Añade tu IP: Si ves un mensaje de error que menciona una IP específica que no coincide con la tuya, añade la IP correcta a la lista blanca. Si no sabes cuál es, busca "¿Cuál es mi IP?" en Google y añade esa.

A veces, el valor a añadir es % (sin comillas), que permite conexiones desde cualquier IP. Sin embargo, esto es menos seguro, úsalo solo como solución temporal.

[WARNING] Añadir % abre tu base de datos a todo el mundo. No es una solución recomendada a largo plazo. Si tu proveedor no te deja configurar esto, contacta con ellos y pregunta específicamente por el "host remoto" de la base de datos.

Paso 5: Reparar la base de datos (La función olvidada)

WordPress tiene una función oculta para reparar bases de datos. Es como un "chequeo médico" para el almacén.

Activando el modo de reparación

Edita tu archivo wp-config.php (el mismo del Paso 1).
Añade la siguiente línea justo antes de la línea que dice /* ¡Eso es todo, deja de editar! Feliz publicación. */:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ahora, en tu navegador, ve a esta dirección (cambia tudominio.com por el tuyo):

https://tudominio.com/wp-admin/maint/repair.php

Verás una página con dos opciones. Haz clic en "Reparar la base de datos". Si eso no funciona, prueba con "Reparar y Optimizar la base de datos".
Cuando termine, ELIMINA LA LÍNEA que añadiste del archivo wp-config.php y súbelo de nuevo.

[INFO] Este proceso es seguro y no borra datos, solo corrige tablas dañadas. Es una herramienta excelente para el error wordpress base de datos.

Paso 6: Verificar los permisos de archivos y carpetas

Aunque es menos común, unos permisos incorrectos pueden impedir que WordPress lea el archivo de configuración o se comunique con la base de datos.

Los permisos correctos

En tu servidor, los archivos deben tener permisos 644 y las carpetas 755.

¿Cómo cambiarlos?

Con tu cliente FTP (FileZilla), selecciona la carpeta raíz de tu instalación.
Haz clic derecho y selecciona "Permisos de archivos" o "Atributos".
Asegúrate de que las carpetas tengan 755 y los archivos 644.
Aplica los cambios a todas las carpetas y archivos internos (opción "Recursivo" en FileZilla).

Paso 7: Aumentar el límite de memoria de PHP

A veces, el error no es de conexión, sino de memoria. Si tu base de datos es grande y el límite de memoria de PHP es bajo, WordPress puede fallar al intentar conectarse.

Cómo aumentarlo

Añade esta línea a tu archivo wp-config.php:

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

Resumen y Prevención: ¿Qué he aprendido?

Hemos recorrido un camino completo desde lo más básico a lo más técnico. Para resumir, si te vuelve a pasar, sigue esta checklist mental:

¿He cambiado la contraseña de la BD recientemente? -> Actualiza wp-config.php.
¿El servidor de BD está activo? -> Reinícialo desde tu panel.
¿He movido el hosting? -> Revisa el DB_HOST y la IP remota.
¿Alguien ha tocado los archivos? -> Sobrescribe el núcleo de WordPress.

Consejos para el futuro

Mantén todo actualizado: WordPress, temas y plugins. Las actualizaciones corrigen errores de seguridad que pueden causar estos fallos.
Usa un plugin de caché: Reduce la carga del servidor y de la base de datos.
Elige un buen hosting: Un buen proveedor te dará herramientas fáciles de usar (como Syspanel en el puerto 2106) y un soporte técnico que te ayudará a resolver estos problemas rápidamente.

Espero que esta guía te haya sido de gran ayuda. El error de conexión con la base de datos es un susto, pero con paciencia y estos pasos, tendrás tu web funcionando en un abrir y cerrar de ojos. Si has llegado hasta aquí y nada funciona, no dudes en contactar con tu proveedor de hosting; para eso están. ¡Mucho ánimo y a seguir creciendo con WordPress!