Error de conexión a BD en WordPress: Solución DirectAdmin

[INFO] Este artículo está pensado para usuarios de WordPress que utilizan el panel de control DirectAdmin. Si tu web muestra el temido mensaje "Error establishing a database connection", no te preocupes. Aquí tienes una guía paso a paso, en lenguaje claro y sin tecnicismos, para resolverlo en la mayoría de los casos. Vamos a ello.

Cuando visitas tu sitio web y en lugar de tu contenido aparece un aviso en inglés que dice "Error establishing a database connection", significa que WordPress no puede comunicarse con la base de datos donde se guardan tus artículos, páginas, comentarios y ajustes. Es uno de los errores más comunes, pero también uno de los más fáciles de solucionar si sigues un orden lógico de comprobaciones.

Piensa en tu web como un edificio. WordPress es el portero, la base de datos es el almacén donde se guardan todos los muebles y documentos. Si el portero no encuentra la llave del almacén, o el almacén está cerrado por reformas, no puede sacar nada. Eso es exactamente lo que ocurre con este error.

En este artículo te explicaré, paso a paso y de forma muy visual, cómo diagnosticar y solucionar el error de conexión base datos WordPress cuando tu hosting está gestionado con DirectAdmin. No necesitas ser un experto, solo seguir las instrucciones con calma.

Primeros pasos: Respira y comprueba lo básico

Antes de entrar en archivos de configuración, es fundamental descartar problemas temporales. Muchas veces el error aparece por un mantenimiento del servidor o un pico de conexiones.

1. Espera unos minutos y recarga

El primer consejo es el más simple. A veces el servidor de bases de datos (MySQL o MariaDB) se reinicia o está haciendo una copia de seguridad pesada. Espera 2 o 3 minutos y pulsa F5 en tu navegador. Si el problema persiste, continúa con el siguiente paso.

2. Revisa el estado general del servidor

Accede a tu panel de DirectAdmin. Normalmente, en la página principal verás un resumen del estado de los servicios. Busca una sección que diga "Servicios" o "System Status". Asegúrate de que MySQL o MariaDB aparece en verde y con la palabra "Running".

[WARNING] Si el servicio de MySQL aparece en rojo o como "Stopped", no intentes arreglarlo tú. Contacta con tu proveedor de hosting de inmediato y diles que el servicio MySQL está caído. Es un problema del servidor, no de tu sitio web.

La causa más común: Los datos de acceso en wp-config.php

Si el servicio de base de datos está activo, el siguiente sospechoso es el archivo de configuración principal de WordPress: wp-config.php. Este archivo contiene las "llaves" (nombre de usuario, contraseña y nombre de la base de datos) que WordPress necesita para conectar con el almacén.

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

Tienes dos formas de hacerlo: desde el administrador de archivos de DirectAdmin o mediante un cliente FTP como FileZilla. Para este tutorial, usaremos el administrador de archivos, que es más visual y no requiere programas externos.

Entra en tu panel de DirectAdmin.
Busca y haz clic en el icono "Administrador de archivos" (File Manager).
Navega hasta la carpeta domains y luego tudominio.com. Si tu web está en una subcarpeta como public_html, entra ahí. La ubicación típica es: domains/tudominio.com/public_html/.
Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona "Editar" o "Edit".

¿Qué debo buscar dentro del archivo?

Dentro del archivo verás líneas de código PHP. Busca las líneas que empiezan por:

define('DB_NAME', ...)
define('DB_USER', ...)
define('DB_PASSWORD', ...)
define('DB_HOST', ...)

Estas cuatro líneas son las que controlan la conexión. Los valores deben coincidir exactamente con los que creaste al instalar WordPress o con los que te proporcionó tu hosting.

Corrigiendo los datos de la base de datos

Aquí es donde se resuelven el 90% de los casos de directadmin wordpress error bd. Los problemas más habituales son:

Contraseña incorrecta: Copiaste mal la contraseña al instalarlo o alguien la cambió desde el panel de MySQL y no actualizaste este archivo.
Nombre de usuario incorrecto: En DirectAdmin, el nombre de usuario de la base de datos suele tener un prefijo. Por ejemplo, si tu usuario de DirectAdmin es usuario1, la base de datos se llamará usuario1_wordpress y el usuario usuario1_wpuser. A veces la gente se olvida de poner el prefijo.
Nombre de la base de datos incorrecto: Igual que el punto anterior, debe incluir el prefijo de tu usuario.

La mejor manera de verificar estos datos es ir a la sección "MySQL Management" en tu panel de DirectAdmin. Allí verás una lista de tus bases de datos y los usuarios asociados. Puedes ver los nombres exactos y, si es necesario, cambiar la contraseña de un usuario de base de datos desde ese mismo panel.

[TIP] Si cambias la contraseña desde MySQL Management, asegúrate de actualizarla también en el archivo wp-config.php. Es un proceso de dos pasos que mucha gente olvida.

Pasos para corregir el wp-config.php

Anota el nombre exacto de la base de datos y el usuario desde el panel de MySQL de DirectAdmin.
Ve al archivo wp-config.php que tienes abierto en el editor.
Modifica las líneas DB_NAME y DB_USER con los valores correctos.
Si has cambiado la contraseña en el panel, escribe la nueva en la línea DB_PASSWORD.
Guarda los cambios. En el editor de DirectAdmin, suele haber un botón "Save" en la parte superior derecha.
Recarga tu sitio web.

Si el error persiste, pasa al siguiente punto.

El anfitrión de la base de datos (DB_HOST)

El valor DB_HOST suele ser localhost en la mayoría de los servidores compartidos con DirectAdmin. Sin embargo, algunos servidores más avanzados utilizan un hostname específico como mysql.tudominio.com o una dirección IP interna.

¿Cómo saber cuál es el host correcto?

Opción A: Pregunta a tu proveedor de hosting. Ellos te dirán el hostname exacto.
Opción B: Si tienes acceso a la sección "MySQL Management" en DirectAdmin, a veces el propio panel te muestra el host en la información de la base de datos. Si no aparece, prueba con localhost.
Opción C: Si recientemente has migrado tu web desde otro hosting, es muy probable que el DB_HOST haya cambiado. Este es un error clásico en migraciones.

Probando el host correcto

En tu archivo wp-config.php, localiza la línea define('DB_HOST', '...');.
Cambia el valor entre comillas a localhost.
Guarda y prueba.

Si no funciona, y tu proveedor te ha dado un hostname específico, pruébalo. Es un proceso de prueba y error, pero es seguro hacerlo siempre que guardes el archivo.

[INFO] Si estás usando un servidor con Syspanel (antes conocido como HestiaCP), recuerda que el puerto de acceso a tu panel de control es el 2106. El proceso de edición de archivos y configuración es similar, pero la ubicación del archivo suele ser en la ruta /home/usuario/web/tudominio/public_html/wp-config.php. El concepto es el mismo: verificar que los datos de la base de datos son correctos.

Solución avanzada: Reparar la base de datos

WordPress tiene una función oculta para reparar bases de datos dañadas. Si los datos de acceso son correctos pero el error persiste, es posible que la base de datos tenga tablas corruptas.

Activando el modo de reparación

Accede de nuevo a tu archivo wp-config.php.
Busca la línea que dice define('WP_DEBUG', false);.
Justo encima de esa línea, añade esta nueva línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Ahora, ve a la siguiente URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos opciones. Haz clic en "Repair Database" (Reparar base de datos) para intentar arreglar las tablas automáticamente.
Espera a que termine. Te mostrará un mensaje de éxito o error.
IMPORTANTE: Después de la reparación, vuelve a tu wp-config.php y elimina la línea define('WP_ALLOW_REPAIR', true);. Dejarla activa es un riesgo de seguridad muy grave, ya que cualquiera podría reparar (o dañar) tu base de datos.

[WARNING] No dejes la línea WP_ALLOW_REPAIR activa. Es como dejar la puerta de tu casa abierta de par en par. Elimínala siempre después de usarla.

Otras causas menos comunes pero importantes

Si has llegado hasta aquí, has agotado las causas más probables. Veamos algunas alternativas.

El archivo .htaccess está corrupto

Un .htaccess dañado puede causar redirecciones extrañas y problemas de carga, aunque es menos común que cause el error de conexión a BD. Para probar, renombra el archivo .htaccess a .htaccess.backup desde el administrador de archivos. Si la web funciona (aunque los enlaces permanentes se rompan), el problema era ese. Luego ve a Ajustes > Enlaces permanentes en el panel de WordPress y guarda para regenerarlo.

Permisos de archivos incorrectos

Los permisos de los archivos deben ser 644 y los de las carpetas 755. Si están en 777 (permisos totales), puede ser un problema de seguridad que algunos servidores bloqueen. Selecciona todos los archivos en el administrador de archivos y cambia los permisos a 644, y las carpetas a 755.

Problemas con plugins de caché o seguridad

A veces, un plugin de caché guarda una versión "rota" de la web. Si puedes acceder a tu panel de administración (tudominio.com/wp-admin), intenta desactivar todos los plugins. La forma más fácil es renombrar la carpeta plugins a plugins_old desde el administrador de archivos. Si la web se arregla, el problema era un plugin. Luego puedes ir reactivándolos uno a uno.

Sobrecarga del servidor

Si tu web recibe mucho tráfico o un script está consumiendo todos los recursos, el servidor de bases de datos puede estar saturado y rechazar conexiones. Esto es más difícil de solucionar desde el panel, pero puedes intentar optimizar tu base de datos desde phpMyAdmin (si tienes acceso) o contactar con el soporte.

Resumen y checklist final

Para solucionar error wordpress de conexión, sigue este orden:

Esperar y recargar (Descartar problema temporal).
Comprobar el estado de MySQL en DirectAdmin (¿Está corriendo?).
Verificar los datos en wp-config.php contra el panel de MySQL (Nombre de BD, usuario y contraseña).
Comprobar el DB_HOST (¿Es localhost o un hostname específico?).
Activar la reparación de BD con WP_ALLOW_REPAIR y luego desactivarla.
Renombrar .htaccess y revisar permisos.
Desactivar plugins renombrando la carpeta.

[TIP] Si después de todo esto el error persiste, el problema es casi con certeza del servidor, no de tu sitio. Guarda todos los datos que has comprobado (host, usuario de BD, etc.) y abre un ticket de soporte con tu proveedor de hosting. Diles exactamente qué has hecho: "He verificado que MySQL está activo, he comprobado los datos en wp-config.php y he intentado reparar la BD. El error persiste". Esto les ahorrará tiempo y te ayudarán más rápido.

Preguntas frecuentes (FAQ)

¿Perderé mis datos si edito wp-config.php?

No. El archivo wp-config.php solo contiene la configuración de conexión. No toca tus artículos, páginas ni usuarios. Lo peor que puede pasar es que rompas la conexión, pero puedes revertir los cambios fácilmente.

¿Qué pasa si no recuerdo mi contraseña de la base de datos?

No hay problema. Entra en DirectAdmin > MySQL Management, busca el usuario de tu base de datos y haz clic en "Change Password". Elige una nueva contraseña segura y actualízala en el wp-config.php.

¿Es lo mismo este error en DirectAdmin que en cPanel?

El error es el mismo, pero la interfaz para gestionar las bases de datos cambia. En cPanel se llama "MySQL Databases" y en DirectAdmin "MySQL Management". El archivo wp-config.php y la lógica son idénticos.

¿Puedo usar el puerto 2106 para algo relacionado con este error?

No. El puerto 2106 es exclusivamente para acceder al panel de control Syspanel (HestiaCP). No tiene nada que ver con la conexión a la base de datos de WordPress. Si tu hosting usa Syspanel, el proceso de edición de archivos se hace a través de su administrador de archivos, pero la solución del error es la misma que aquí.

¿Por qué aparece este error después de una migración?

Porque los datos de acceso a la base de datos cambian entre servidores. Es el error más común en migraciones. Simplemente actualiza los valores en wp-config.php con los nuevos datos que te haya dado el nuevo hosting.

Espero que esta guía te haya sido de gran ayuda. La paciencia es clave en estos casos. Ve paso a paso y, sobre todo, no te saltes la comprobación de los datos en el panel de DirectAdmin, ya que es la fuente de la verdad para saber qué valores debe tener tu archivo de configuración.