Solucionar error de conexión a base de datos WordPress en DirectAdmin

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, probablemente te has encontrado con el temido error de conexión a base de datos en WordPress. No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. En esta guía, te explicaré paso a paso cómo diagnosticar y solucionar el error base datos cuando tu sitio está alojado en un panel DirectAdmin. Vamos a ello.

¿Qué significa este error?

Cuando ves el mensaje "Error establishing a database connection" (Error al establecer la conexión con la base de datos) o un error similar en tu sitio WordPress, significa que WordPress no puede comunicarse con la base de datos donde se almacena todo tu contenido (posts, páginas, usuarios, configuraciones, etc.). Es como si tu sitio web hubiera perdido el teléfono de su mejor amigo: no puede llamar a la base de datos para pedirle la información que necesita para mostrarse.

Este error puede aparecer por muchas razones, desde un simple cambio de contraseña hasta un problema más serio en el servidor. Pero no te asustes: en el 90% de los casos, tiene una solución sencilla que puedes aplicar tú mismo.

Causas comunes del error de conexión a base de datos en WordPress con DirectAdmin

Antes de empezar a hacer cambios, es importante entender qué puede estar causando el problema. Aquí tienes las causas más frecuentes:

Credenciales incorrectas: El nombre de la base de datos, el usuario o la contraseña han cambiado o están mal escritos en el archivo de configuración de WordPress (wp-config.php).
Servidor de base de datos caído: El servicio MySQL o MariaDB (el motor de base de datos) no está funcionando en tu servidor.
Archivo wp-config.php dañado o mal configurado: Este archivo contiene la información de conexión. Si se corrompe o lo modificas sin cuidado, el sitio deja de funcionar.
Problemas de permisos o cuota: El usuario de la base de datos no tiene permisos suficientes, o has alcanzado el límite de almacenamiento (cuota) de tu plan de hosting.
Ataques o malware: En casos raros, un ataque puede modificar el archivo de configuración o dañar la base de datos.

Ahora que sabes las causas, vamos a la solución. Sigue estos pasos en orden.

Paso 1: Verificar el estado del servidor de base de datos

Lo primero es asegurarte de que el motor de base de datos (MySQL/MariaDB) está funcionando en tu servidor. Si no está activo, WordPress no podrá conectarse.

Para usuarios de DirectAdmin

Accede a DirectAdmin: Ingresa a tu panel de control usando la URL que te proporcionó tu proveedor de hosting (normalmente algo como tudominio.com:2222).
Busca la sección de "System Info" o "Server Info": En DirectAdmin, ve a "Account Manager" > "System Info & Files" > "Server Info". Allí podrás ver el estado de los servicios.
Revisa el estado de MySQL: Busca una línea que diga "MySQL" o "MariaDB". Si está en verde o dice "Running", el servicio está activo. Si está en rojo o dice "Stopped", tendrás que iniciarlo.

[INFO] Si no ves esta opción, es posible que tu plan de hosting no te permita ver el estado del servidor. En ese caso, contacta a tu proveedor de hosting y pregúntales si el servicio MySQL está funcionando. Ellos pueden reiniciarlo en segundos.

Si usas Syspanel (antes HestiaCP)

Si tu hosting utiliza Syspanel (el antiguo HestiaCP), el acceso es por el puerto 2106 (por ejemplo, tudominio.com:2106). Una vez dentro, ve a "Server" > "Services" y busca MySQL. Asegúrate de que esté en "Running".

Paso 2: Comprobar las credenciales en el archivo wp-config.php

Este es el paso más común y donde suele estar el error. El archivo wp-config.php es el cerebro de la conexión. Si los datos están mal, WordPress no se conecta.

Accede a tu hosting por FTP o por el administrador de archivos de DirectAdmin:
- En DirectAdmin, ve a "File Manager" (dentro de tu cuenta).
- Navega hasta la carpeta public_html (o la carpeta donde tengas instalado WordPress).
Busca el archivo wp-config.php y haz clic derecho para editarlo (o descárgalo y edítalo con un editor de texto como Notepad++ o Sublime Text).

Busca estas líneas (normalmente al principio del archivo):

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');

Verifica que los datos sean correctos:
- DB_NAME: El nombre exacto de tu base de datos (suele tener un prefijo como tuusuario_).
- DB_USER: El usuario asociado a esa base de datos.
- DB_PASSWORD: La contraseña de ese usuario.
- DB_HOST: Normalmente es localhost, pero algunos hosts usan una dirección IP o un nombre como mysql.tudominio.com. Si no estás seguro, déjalo como localhost.

[WARNING] Ten mucho cuidado al editar este archivo. No borres ni añadas nada más. Si no estás seguro, descarga una copia de seguridad antes de modificar.

¿Cómo obtener las credenciales correctas desde DirectAdmin?

En DirectAdmin, ve a "MySQL Management" (o "Databases").
Verás una lista de bases de datos. Busca la que usa tu WordPress.
Haz clic en el icono de "lápiz" o "editar" junto al usuario de la base de datos para ver/restablecer la contraseña.
Copia exactamente el nombre de la base de datos, el usuario y la contraseña (o cámbiala si es necesario).

[TIP] Si cambias la contraseña en DirectAdmin, recuerda actualizarla también en el archivo wp-config.php. De lo contrario, el error persistirá.

Paso 3: Restablecer la contraseña de la base de datos desde DirectAdmin

A veces, la contraseña se ha cambiado sin que te des cuenta (por ejemplo, después de una migración o un cambio de proveedor). La forma más segura es restablecerla desde el panel:

En DirectAdmin, ve a "MySQL Management".
Localiza tu base de datos y el usuario asociado.
Haz clic en "Change Password" o en el icono de candado.
Establece una nueva contraseña segura (puedes usar el generador que ofrece el panel).
Actualiza el archivo wp-config.php con la nueva contraseña.

Paso 4: Verificar los permisos del usuario de la base de datos

Si las credenciales son correctas pero el error persiste, puede que el usuario no tenga todos los permisos necesarios.

En DirectAdmin, ve a "MySQL Management".
Haz clic en el nombre de la base de datos para ver los usuarios asignados.
Asegúrate de que el usuario tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). Normalmente, la opción "All Privileges" es la que debes seleccionar.
Si no, edita los permisos y guárdalos.

Paso 5: Probar la conexión manualmente

Una forma sencilla de saber si el problema es de WordPress o de la base de datos es probar la conexión manualmente.

Crea un archivo llamado test.php en la carpeta public_html (puedes hacerlo desde el File Manager de DirectAdmin).

Pega este código dentro:

<?php
$conexion = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_datos');
if (!$conexion) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo 'Conexión exitosa a la base de datos.';
mysqli_close($conexion);
?>

Recuerda reemplazar tu_usuario, tu_contraseña y tu_base_datos con los datos reales.

Guarda el archivo y accede a él desde tu navegador: tudominio.com/test.php.
Si ves "Conexión exitosa", el problema está en otro lugar (probablemente en el archivo wp-config.php o en algún plugin). Si ves un error, entonces la base de datos no está aceptando la conexión.

[WARNING] No olvides eliminar el archivo test.php después de la prueba, ya que contiene información sensible de tu base de datos.

Paso 6: Reparar la base de datos desde WordPress

WordPress tiene una herramienta de reparación integrada que puede solucionar problemas menores en la base de datos.

Agrega esta línea al archivo wp-config.php (justo antes de la línea que dice /* That's all, stop editing! */):
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Ve a esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
Haz clic en "Repair Database" (Reparar base de datos). También puedes elegir "Repair and Optimize" para una limpieza más profunda.
Una vez terminado, elimina la línea que añadiste del wp-config.php por razones de seguridad.

Paso 7: Revisar la cuota de disco y los límites del hosting

Si tu plan de hosting tiene un límite de almacenamiento y lo has superado, la base de datos puede dejar de funcionar.

En DirectAdmin, ve a "Account Manager" > "Usage" o "Statistics".
Revisa el espacio usado en la base de datos y en los archivos.
Si estás cerca del límite, libera espacio (elimina plugins, temas o archivos temporales) o contacta a tu proveedor para aumentar la cuota.

Paso 8: Desactivar plugins y temas por FTP

A veces, un plugin o tema mal codificado puede corromper la conexión. Si no puedes acceder al panel de administración de WordPress, puedes desactivarlos manualmente desde el servidor.

Conéctate por FTP o usa el File Manager de DirectAdmin.
Ve a la carpeta wp-content.
Cambia el nombre de la carpeta plugins a plugins_old. Esto desactivará todos los plugins.
Si el error desaparece, vuelve a cambiar el nombre a plugins y desactiva los plugins uno por uno desde el panel de administración (si ya puedes acceder) para encontrar el culpable.
Si el problema persiste, prueba cambiando el nombre de la carpeta themes a themes_old. WordPress usará un tema por defecto.

Paso 9: Verificar el archivo .htaccess

Un archivo .htaccess dañado puede causar problemas de conexión (aunque es menos común).

En el File Manager, busca el archivo .htaccess en la carpeta public_html.
Renómbralo a .htaccess_old.
Ve a tudominio.com/wp-admin/ e inicia sesión. WordPress generará un nuevo .htaccess automáticamente.
Si no puedes acceder, ve a "Ajustes" > "Enlaces permanentes" y haz clic en "Guardar cambios" para regenerarlo.

Paso 10: Contactar al soporte técnico

Si después de todos estos pasos el error persiste, es hora de pedir ayuda profesional. El problema puede estar en el servidor (por ejemplo, un firewall bloqueando conexiones, un problema de configuración de MySQL, o un ataque DDoS). Tu proveedor de hosting tiene las herramientas para diagnosticar y solucionar estos problemas.

[INFO] Cuando contactes al soporte, diles exactamente qué pasos has seguido. Esto les ahorrará tiempo y te ayudará a obtener una solución más rápida.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error de conexión a base de datos después de cambiar la contraseña de MySQL?

Porque olvidaste actualizar el archivo wp-config.php con la nueva contraseña. Sigue el Paso 2 de esta guía para corregirlo.

¿El error puede deberse a un ataque de hackers?

Sí, aunque es menos común. Si sospechas de un ataque, cambia todas las contraseñas (de WordPress, base de datos y FTP) y revisa el archivo wp-config.php en busca de líneas extrañas. También puedes escanear tu sitio con plugins de seguridad.

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

Puedes restablecerla desde DirectAdmin (Paso 3). Luego, actualiza el wp-config.php.

¿El error aparece solo a veces? ¿Por qué?

Puede deberse a un pico de tráfico que sobrecarga el servidor de base de datos, o a un problema intermitente de conexión. Si es frecuente, contacta a tu hosting para que revisen el servidor.

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

No, la reparación solo corrige tablas dañadas. No borra contenido. Sin embargo, siempre es recomendable hacer una copia de seguridad antes de cualquier operación.

Conclusión

El error de conexión a base de datos en WordPress puede ser frustrante, pero como has visto, la mayoría de las veces se soluciona con unos pocos pasos sencillos. Recuerda siempre empezar por lo más básico: verificar las credenciales en el wp-config.php y el estado del servicio MySQL. Si todo falla, no dudes en pedir ayuda a tu proveedor de hosting.

Espero que esta guía te haya sido útil. Si tienes alguna otra duda, recuerda que estoy aquí para ayudarte. ¡Buena suerte y a seguir disfrutando de tu WordPress!