Solucionar 'Error establishing a database connection' en DirectAdmin

¿Qué significa el error "Error establishing a database connection"?

Este es uno de los errores más comunes y, a la vez, más frustrantes en WordPress. Cuando lo ves en tu pantalla, significa que tu sitio web no puede comunicarse con la base de datos donde se almacenan tus contenidos, usuarios, comentarios y configuraciones.

Piénsalo así: tu WordPress es como una tienda, y la base de datos es el almacén donde guardas todos los productos. Si la puerta del almacén está cerrada o la llave no funciona, no puedes atender a tus clientes. El mensaje de error conexión base datos WordPress es exactamente eso: la puerta está bloqueada.

En un entorno como DirectAdmin, este problema puede deberse a varias causas, desde un cambio de contraseña hasta un ataque malintencionado. Lo bueno es que, en la mayoría de los casos, tiene solución siguiendo pasos lógicos y sencillos. A continuación, te explico cómo diagnosticar y solucionar el DirectAdmin WordPress error paso a paso, sin necesidad de ser un experto técnico.

Paso 1: Verifica si el problema es general o solo de tu base de datos

Antes de tocar nada, necesitas saber si el fallo viene de tu sitio completo o solo de la base de datos.

Comprueba si tu panel de control funciona

Accede a tu DirectAdmin (normalmente en https://tu-dominio.com:2222). Si el panel carga correctamente, significa que el servidor está funcionando y el problema está limitado a la conexión con la base de datos. Si el panel tampoco carga, es un problema de servidor más grave y deberías contactar con tu proveedor de hosting.

Prueba con un archivo de prueba

Crea un archivo llamado test.php en la raíz de tu dominio (carpeta public_html o domains/tudominio.com/public_html). Dentro, pega este código:

<?php
$conn = mysqli_connect("localhost", "USUARIO_BD", "CONTRASEÑA_BD", "NOMBRE_BD");
if (!$conn) {
    die("Error: " . mysqli_connect_error());
} else {
    echo "Conexión exitosa";
}
?>

Sustituye los datos por los de tu base de datos (los encontrarás en el archivo wp-config.php de tu WordPress). Si ves "Conexión exitosa", el servidor de base de datos funciona y el problema está en la configuración de WordPress. Si ves un error, el problema está en las credenciales o en el servidor de bases de datos.

[INFO] No olvides eliminar el archivo test.php después de la prueba. Dejarlo en el servidor es un riesgo de seguridad.

Paso 2: Revisa el archivo wp-config.php (la causa más común)

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene las credenciales de acceso a tu base de datos. Si algo está mal ahí, tu sitio no puede conectarse.

Cómo acceder al archivo

Entra a DirectAdmin y abre el Administrador de Archivos.
Navega hasta la carpeta public_html (o la carpeta de tu dominio si es un subdominio).
Busca el archivo wp-config.php y haz clic en "Editar".

Qué debes revisar

Busca estas líneas:

define('DB_NAME', 'tu_base_de_datos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Verifica que:

DB_NAME sea exactamente el nombre de tu base de datos (suele tener un prefijo como usuario_nombrebd).
DB_USER sea el usuario correcto.
DB_PASSWORD sea la contraseña actual. Si hace poco la cambiaste desde DirectAdmin, aquí debe estar actualizada.
DB_HOST normalmente es localhost, pero algunos servidores usan 127.0.0.1 o una dirección específica. Revisa la documentación de tu hosting.

[WARNING] Si no estás seguro de las credenciales, no las inventes. Ve a DirectAdmin → "MySQL Management" y verifica los datos exactos. Un solo carácter mal escrito provoca el Error establishing database connection.

Solución rápida: actualiza la contraseña

Si cambiaste la contraseña de la base de datos recientemente y olvidaste actualizar wp-config.php, hazlo ahora. Guarda el archivo y recarga tu web. En la mayoría de los casos, este simple paso resuelve el problema.

Paso 3: Verifica que la base de datos existe y no está corrupta

A veces la base de datos se elimina por error, se corrompe o el usuario no tiene permisos suficientes.

Desde DirectAdmin

Ve a MySQL Management en tu panel.
Comprueba que tu base de datos aparece en la lista. Si no aparece, tendrás que crearla de nuevo.
Si aparece, haz clic en "Manage" y verifica que el usuario asociado tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).

¿Base de datos corrupta?

Si todo parece correcto pero el error persiste, la base de datos puede estar dañada. Puedes intentar repararla desde el propio DirectAdmin:

En MySQL Management, selecciona tu base de datos.
Busca la opción "Repair" o "Check" (algunos paneles lo llaman "Optimize").
Ejecuta la reparación y vuelve a intentar cargar tu sitio.

[INFO] Si no encuentras la opción de reparación, puedes usar phpMyAdmin (disponible en DirectAdmin) y ejecutar REPAIR TABLE en las tablas de WordPress.

Paso 4: Comprueba si hay límites de conexión o bloqueos

A veces, el problema no es de credenciales sino de límites de conexiones. Si tu base de datos tiene un número máximo de conexiones simultáneas y tu sitio recibe mucho tráfico, puede saturarse.

Qué hacer en este caso

Reinicia el servicio de MySQL/MariaDB: Desde DirectAdmin, ve a "System Info" o "Services" y busca el servicio de base de datos. Reinícialo. Esto libera las conexiones colgadas.
Revisa los logs: En DirectAdmin, busca "Error Logs" dentro de tu dominio. Busca mensajes como Too many connections o Can't connect to local MySQL server. Esto te dará pistas.

[WARNING] Reiniciar el servicio de base de datos puede provocar una caída momentánea de todos los sitios que dependan de él. Hazlo con precaución y preferiblemente en horas de bajo tráfico.

Paso 5: Revisa si hay plugins o temas problemáticos

Aunque el error conexión base datos WordPress suele estar relacionado con la configuración, a veces un plugin o tema mal codificado puede forzar una conexión incorrecta o agotar los recursos.

Solución: desactiva todo temporalmente

Accede a tu servidor por FTP o usa el Administrador de Archivos de DirectAdmin.
Ve a public_html/wp-content/plugins/.
Cambia el nombre de la carpeta de un plugin (por ejemplo, akismet → akismet_old). Esto lo desactiva sin pasar por el panel.
Repite con todos los plugins.
Intenta cargar tu web. Si funciona, reactiva los plugins uno a uno hasta encontrar el culpable.

Si el problema persiste, haz lo mismo con la carpeta del tema en public_html/wp-content/themes/.

Paso 6: Verifica los permisos de archivos y carpetas

Los permisos incorrectos pueden impedir que WordPress lea el archivo de configuración o acceda a los archivos de la base de datos.

Permisos correctos

Carpetas: 755
Archivos: 644
wp-config.php: 600 o 640 (más seguro)

En DirectAdmin, selecciona los archivos y carpetas, haz clic en "Change Permissions" y ajusta los valores.

[TIP] Si no sabes qué permisos tienen, verifica que wp-config.php no sea de solo lectura. Si es así, cámbialo a 644, edita el archivo y luego vuelve a ponerlo en 600.

Paso 7: Comprueba si el servidor de base de datos está en otra dirección

En algunos planes de hosting, la base de datos no está en localhost, sino en un servidor separado. Esto es más común en hosting gestionado o en entornos VPS.

Dónde encontrar la dirección correcta

Revisa el correo de bienvenida de tu hosting.
En DirectAdmin, ve a MySQL Management y busca el campo "Host" o "Server". A veces aparece como localhost pero en otros casos es algo como mysql.tudominio.com.

Actualiza DB_HOST en wp-config.php con la dirección correcta.

Paso 8: Restaura desde una copia de seguridad

Si has probado todo y el error persiste, es posible que el archivo wp-config.php esté dañado o que la base de datos esté demasiado corrupta.

Restaurar solo wp-config.php

Descarga una copia de seguridad reciente de tu WordPress.
Extrae el archivo wp-config.php original.
Súbelo a tu servidor reemplazando el actual.

Restaurar la base de datos

Si tienes una copia de seguridad de la base de datos (por ejemplo, desde el Backup Manager de DirectAdmin), puedes restaurarla:

Ve a Backup Manager en DirectAdmin.
Sube tu copia de seguridad o selecciona la existente.
Restaura la base de datos.

[WARNING] Restaurar una base de datos sobrescribirá todos los cambios posteriores a la copia. Asegúrate de que es la acción correcta antes de continuar.

Paso 9: Contacta con tu proveedor de hosting

Si después de todos estos pasos sigues viendo el mensaje de Error establishing database connection, es hora de pedir ayuda profesional.

Qué información debes proporcionar

El mensaje de error exacto.
Lo que has intentado (menciona los pasos de esta guía).
Si has modificado algo recientemente.
La fecha y hora en que empezó el problema.

Tu proveedor podrá revisar los logs del servidor, comprobar el estado del servicio MySQL/MariaDB y verificar si hay algún bloqueo a nivel de firewall o de red.

[TIP] Si tu hosting usa Syspanel en lugar de DirectAdmin, el proceso es similar. Recuerda que en Syspanel el puerto de acceso es el 2106 y las opciones de gestión de bases de datos se encuentran en la sección "Bases de datos" del panel.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si restauro la base de datos?

Sí, si restaura una copia antigua, perderás los cambios posteriores. Por eso es importante hacer copias de seguridad regulares. Si no tienes una copia reciente, intenta primero los pasos de reparación.

¿El error puede deberse a un ataque informático?

Es posible. Un atacante podría haber cambiado las contraseñas de la base de datos o eliminado tablas. Si sospechas de un ataque, cambia todas las contraseñas (base de datos, usuario de DirectAdmin, contraseña de WordPress) y revisa los logs de acceso.

¿Necesito conocimientos técnicos para arreglarlo?

No, la mayoría de los pasos de esta guía son accesibles para cualquier persona que pueda navegar por el panel de control. Solo necesitas paciencia y seguir las instrucciones al pie de la letra.

¿Qué hago si no encuentro el archivo wp-config.php?

Asegúrate de estar en la carpeta correcta. En instalaciones estándar, está en public_html/wp-config.php. Si usas una estructura con subdominios, busca en public_html/subdominio/wp-config.php. Si no existe, es posible que tu instalación de WordPress esté incompleta.

¿Cuánto tiempo se tarda en solucionar?

Depende de la causa. Si es un problema de contraseña, lo resuelves en 5 minutos. Si es corrupción de base de datos, puede llevar más tiempo. En general, entre 15 y 30 minutos siguiendo estos pasos.

Conclusión

El Error establishing database connection en DirectAdmin es un problema frustrante pero casi siempre solucionable. La clave está en ir descartando causas de forma metódica: primero las credenciales, luego la existencia de la base de datos, después los permisos y por último los plugins o temas.

Recuerda que la prevención es la mejor cura. Realiza copias de seguridad periódicas, usa contraseñas fuertes y mantén tu WordPress, plugins y temas actualizados. Así minimizarás las posibilidades de encontrarte con este error.

Si has llegado hasta aquí y has seguido todos los pasos, en la mayoría de los casos tu sitio web volverá a estar operativo. Y si no, ya tienes información valiosa para dar a tu proveedor de hosting y acelerar el proceso de soporte. ¡Mucha suerte!