Error de conexión a la base de datos en WordPress: Solución definitiva

¡Hola! Si estás leyendo esto, es muy probable que hayas visto el temido mensaje "Error al conectar con la base de datos" en tu sitio WordPress. No te preocupes, respira hondo. Es uno de los fallos más comunes y, en la gran mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin ser un experto en informática.

Este error significa que WordPress no puede comunicarse con el servidor donde se guardan todos tus contenidos (entradas, páginas, usuarios, configuraciones). Es como si intentaras abrir una tienda pero la llave del almacén no girara.

En esta guía completa y paso a paso, vamos a desglosar las causas más frecuentes y, lo más importante, cómo solucionarlo de forma práctica y segura. 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é está pasando. El error base de datos WordPress aparece por varias razones, pero las más habituales son:

Datos de acceso incorrectos: Las credenciales (usuario, contraseña, nombre de la base de datos o servidor) que están en tu archivo de configuración ya no son válidas o tienen un error tipográfico.
El servidor de la base de datos está caído o sobrecargado: A veces, el problema no es tuyo, sino del servidor que aloja tu web. Puede estar en mantenimiento o haber sufrido un pico de tráfico.
El archivo wp-config.php está dañado o corrupto: Este es el archivo más importante de tu WordPress, ya que contiene las instrucciones para conectarse a la base de datos. Si se corrompe, todo se detiene.
Problemas con el plugin o tema que estás usando: Algún código malicioso o incompatible puede estar interfiriendo con la conexión.
El servidor se quedó sin espacio en disco: Si el disco duro del hosting está lleno, la base de datos no puede funcionar correctamente.

Ahora sí, vamos a la acción. Te recomiendo seguir estos pasos en orden, del más fácil al más complejo.

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

A veces, el error conexión WordPress es un problema temporal del servidor. Para comprobarlo, puedes hacer lo siguiente:

Visita la URL de tu sitio web en una ventana de incógnito o con otro navegador. Si el error persiste, continúa.
Accede a tu panel de control de hosting (cPanel, Plesk, o el que uses). Una vez dentro, busca la sección de "Estado del Servidor" o similar. Si hay una alerta de mantenimiento o caída, el problema es del servidor y deberás esperar a que se resuelva.
Prueba a acceder a la URL de administración (tudominio.com/wp-admin). A menudo, si el error es de conexión, verás el mismo mensaje, pero si tienes suerte, podrás entrar y ver un aviso más específico.

[INFO] Si el problema es del servidor, no hay nada que puedas hacer excepto contactar con tu proveedor de hosting y esperar. No te frustres, suele resolverse en poco tiempo.

Paso 2: Revisa tus datos de acceso en `wp-config.php`

Este es el paso más común y donde está la solución en el 80% de los casos. El archivo wp-config.php contiene la información que tu WordPress usa para encontrar y conectarse a la base de datos.

¿Cómo acceder al archivo `wp-config.php`?

Accede a tu hosting a través del administrador de archivos (File Manager) o mediante un cliente FTP como FileZilla.
Navega hasta la carpeta raíz de tu instalación de WordPress. Normalmente se llama public_html, htdocs o www.
Busca el archivo wp-config.php (estará en esa carpeta, no dentro de wp-content ni wp-admin).
Descárgalo a tu ordenador para tener una copia de seguridad antes de editarlo. ¡Esto es muy importante!
Ábrelo con un editor de texto plano como el Bloc de notas o Sublime Text. No uses Word ni Pages, ya que pueden añadir caracteres extraños.

¿Qué tengo que buscar?

Dentro del archivo, verás líneas que empiezan con define. Busca estas cuatro líneas:

DB_NAME (Nombre de la base de datos)
DB_USER (Usuario de la base de datos)
DB_PASSWORD (Contraseña del usuario)
DB_HOST (Servidor de la base de datos, normalmente localhost)

Estas líneas se ven así:

define( 'DB_NAME', 'tu_nombre_de_bd' );
define( 'DB_USER', 'tu_usuario_bd' );
define( 'DB_PASSWORD', 'tu_contraseña_bd' );
define( 'DB_HOST', 'localhost' );

¿Qué debo hacer?

Revisa que no haya espacios en blanco al principio o al final de los valores entre comillas.
Comprueba que las comillas sean simples (') y no dobles ("). Un simple error de sintaxis puede romper la conexión.
Confirma los datos con tu proveedor de hosting. Ve al panel de control de tu hosting y busca la sección de "Bases de Datos MySQL". Ahí verás el nombre de la base de datos, el usuario y podrás cambiar la contraseña. Compara estos datos con los que tienes en el archivo.

[WARNING] Si cambias la contraseña en el panel de tu hosting, debes actualizarla también en este archivo wp-config.php. Si no lo haces, tendrás el mismo error.

Si todo parece correcto pero el error persiste, pasa al siguiente paso.

Paso 3: Repara y optimiza la base de datos (Solución Rápida)

WordPress tiene una función oculta para reparar la base de datos. Esta es una solución mágica para muchos casos.

¿Cómo activar la reparación?

Añade una línea al archivo wp-config.php. Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, pega el siguiente código:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y súbelo de nuevo a tu servidor (si lo habías descargado).
Visita esta URL en tu navegador: 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 (o la segunda si te sientes valiente).
WordPress intentará arreglar cualquier tabla dañada. Al terminar, te dará un mensaje de éxito o error.
¡IMPORTANTE! Una vez terminado, elimina la línea define('WP_ALLOW_REPAIR', true); del archivo wp-config.php y guarda los cambios. Dejar esta opción activa es un riesgo de seguridad.

[INFO] Esta función es como el "desfragmentador" de tu base de datos. No borra nada, solo intenta corregir errores internos. Es muy segura.

Paso 4: Revisa el espacio en disco de tu servidor

Un servidor lleno puede causar todo tipo de problemas, incluido el error base de datos WordPress.

Accede a tu panel de control de hosting.
Busca la sección de "Uso de Disco" o "Estadísticas".
Si el disco está al 100% o cerca, tendrás que liberar espacio. Elimina copias de seguridad antiguas, archivos temporales, caché, o incluso vídeos y fotos de gran tamaño que ya no uses.

[WARNING] Un disco lleno puede provocar también errores 500 y otros fallos graves. Es una buena práctica mantener siempre al menos un 20% de espacio libre.

Paso 5: Comprueba si el problema es un plugin o tema

A veces, un plugin o tema mal configurado puede estar sobrecargando la base de datos o causando conflictos.

¿Cómo comprobarlo?

Accede a tu hosting y ve a la carpeta wp-content.
Renombra la carpeta plugins a plugins_old. Esto desactivará todos tus plugins de golpe.
Vuelve a cargar tu web. Si el error desaparece, el problema era un plugin. Ahora, ve renombrando los plugins de uno en uno (dentro de plugins_old, renombra el que quieras probar a plugins y ve a tu web) hasta encontrar al culpable.
Si el error persiste, renombra la carpeta themes a themes_old. WordPress usará un tema por defecto (Twenty Twenty-Four, por ejemplo). Si esto soluciona el problema, tu tema es el que está causando el fallo.

[TIP] Este método es de prueba y error, pero es muy efectivo. No te preocupes, no borras nada, solo cambias el nombre de las carpetas.

Paso 6: Comprueba la dirección del servidor de la base de datos

Aunque es poco común, a veces el problema no es localhost. Si tu hosting usa un servidor de base de datos externo (por ejemplo, mysql.tudominio.com), es posible que el servidor esté bloqueando la conexión.

Revisa el DB_HOST en tu wp-config.php. Si no es localhost, ve a tu panel de control de hosting y busca cuál es la dirección correcta del servidor MySQL.
Asegúrate de que tu IP no esté bloqueada en el firewall del servidor. Esto es más técnico, pero si has cambiado de IP recientemente (por ejemplo, al cambiar de casa), podría ser la causa.

Paso 7: La solución definitiva: Contacta con tu proveedor de hosting

Si has llegado hasta aquí y el error persiste, es hora de llamar a los profesionales. Contacta con el soporte técnico de tu hosting.

¿Qué información debes darles?

El mensaje de error exacto que ves.
Los pasos que ya has probado (diles "ya he revisado el wp-config.php y he probado con la reparación").
Tu nombre de usuario de hosting.

Ellos tienen acceso a los logs del servidor y podrán ver si hay un error más profundo que no puedes ver tú.

¿Qué pasa con Syspanel y el puerto 2106?

Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP) para gestionar tus sitios, el acceso a tu panel de control se realiza a través del puerto 2106. Es decir, para entrar a tu panel de administración, deberás escribir en tu navegador: https://tudominio.com:2106 o https://tu-ip-del-servidor:2106.

Este panel te dará acceso a la gestión de archivos (donde podrás editar el wp-config.php), a la gestión de bases de datos MySQL y a los logs del sistema. Si tu proveedor usa Syspanel, la mayoría de los pasos anteriores (como acceder al archivo de configuración o a la base de datos) los harás desde este panel.

Preguntas Frecuentes (FAQ)

¿Perderé mis datos si hago todo esto?

No. Los pasos de esta guía se centran en reparar la conexión, no en borrar datos. Las únicas acciones que podrían considerarse "destructivas" son renombrar carpetas de plugins o temas, pero es una acción reversible. Siempre es recomendable hacer una copia de seguridad antes de empezar, pero no deberías perder nada.

¿Por qué veo el error solo en una página y no en todo el sitio?

Esto es raro, pero puede pasar si ese plugin o tema específico que se carga en esa página está haciendo una consulta incorrecta a la base de datos. Sigue el Paso 5 para aislar el problema.

¿El error puede deberse a un ataque de hackers?

Es posible, aunque no es lo más común. Un ataque podría sobrescribir tu wp-config.php o inyectar código malicioso. Si sospechas de esto, revisa la integridad de los archivos de tu WordPress y cambia todas tus contraseñas (hosting, base de datos, usuario admin).

¿Qué hago si el error aparece después de mover mi sitio a otro hosting?

Este es un clásico. Cuando mueves un sitio, las credenciales de la base de datos cambian. Debes asegurarte de que el wp-config.php de tu nuevo hosting tenga los datos correctos del nuevo servidor. A veces también necesitas cambiar la URL del sitio en la base de datos, pero eso es otro tema.

¿Y si todo lo demás falla?

Como último recurso, puedes intentar restaurar una copia de seguridad de tu sitio (tanto de archivos como de base de datos) de una fecha anterior al error. Tu proveedor de hosting suele ofrecer copias de seguridad automáticas.

Conclusión

Ver el error conexión WordPress es un momento de pánico, pero ya ves que tiene solución. La clave es ir paso a paso, sin prisas y con calma. La mayoría de las veces, el problema está en un pequeño error tipográfico en el wp-config.php o en un cambio de contraseña que no se ha actualizado.

Recuerda: primero revisa lo más simple (estado del servidor y credenciales), luego pasa a las soluciones más avanzadas (reparación, plugins) y, si todo falla, no dudes en pedir ayuda a tu proveedor de hosting.

Esperamos que esta guía te haya sido de gran ayuda y que tu sitio web vuelva a estar en línea en un abrir y cerrar de ojos. ¡Buena suerte!