Error conexión base de datos WordPress DirectAdmin | SysAdmin

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los sustos más comunes al gestionar un sitio web en WordPress: el temido mensaje "Error al establecer conexión con la base de datos". Si estás usando DirectAdmin como panel de control, no te preocupes. Este error tiene solución y, con esta guía paso a paso, lo resolverás en pocos minutos. Vamos a ello.

Este error aparece cuando WordPress no puede comunicarse con la base de datos MySQL o MariaDB que almacena todo tu contenido (posts, usuarios, configuraciones). Las causas más frecuentes son: credenciales incorrectas en el archivo wp-config.php, la base de datos o el usuario han sido eliminados accidentalmente, el servidor de base de datos está caído, o hay un problema de permisos.

¿Qué significa exactamente este error?

Cuando ves el mensaje "Error al establecer conexión con la base de datos" o en inglés "Error establishing a database connection", WordPress te está diciendo que no puede encontrar o autenticarse en la base de datos donde guarda toda la información de tu web. Sin esa conexión, tu sitio no puede cargar nada. Es como si intentaras abrir una tienda pero la puerta del almacén estuviera cerrada con llave y no tuvieras la llave correcta.

Paso 1: Verifica que tu base de datos y usuario existan en DirectAdmin

Lo primero es comprobar que la base de datos y el usuario que WordPress espera encontrar realmente existen en tu panel de DirectAdmin.

Inicia sesión en tu panel de DirectAdmin (normalmente en tudominio.com:2222).
Busca la sección "Administrador de MySQL" o "MySQL Management". Suele estar en la sección de "Cuenta" o "Administración de cuentas".
Verás una lista de tus bases de datos. Busca el nombre de la base de datos que usa tu WordPress.
Si no ves ninguna base de datos, o la que buscas no aparece, tendrás que crearla de nuevo. Anota el nombre exacto, el usuario asociado y la contraseña.

[INFO] Si no recuerdas qué base de datos usa tu WordPress, no te preocupes. En el siguiente paso lo descubriremos mirando el archivo wp-config.php.

Paso 2: Localiza y revisa el archivo wp-config.php

Este es el archivo de configuración principal de WordPress. Aquí es donde se guardan las credenciales de la base de datos. Un error al escribir estos datos es la causa más común del problema.

¿Cómo acceder al archivo?

Puedes hacerlo de dos formas:

Opción A: Desde el Administrador de Archivos de DirectAdmin (Recomendado para principiantes)
1. En tu panel de DirectAdmin, busca "Administrador de Archivos" o "File Manager".
2. Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta como public_html/blog).
3. Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona "Editar".
Opción B: Vía FTP (para usuarios más avanzados)
1. Conéctate a tu servidor usando un cliente FTP como FileZilla.
2. Ve a la carpeta raíz de tu WordPress.
3. Descarga el archivo wp-config.php a tu ordenador, edítalo con un editor de texto plano (como el Bloc de Notas) y luego súbelo de nuevo.

¿Qué buscar dentro del archivo?

Dentro del archivo wp-config.php, busca las siguientes líneas. Deben verse algo así:

define('DB_NAME', 'tu_usuario_tu_base_de_datos');
define('DB_USER', 'tu_usuario_tu_usuario');
define('DB_PASSWORD', 'tu_contraseña_segura');
define('DB_HOST', 'localhost');

[WARNING] ¡Cuidado! No confundas este archivo con wp-config-sample.php. Ese es solo una plantilla. El archivo que debes editar es wp-config.php (sin "-sample").

Verifica estos cuatro datos:

DB_NAME: Este es el nombre de la base de datos. Debe coincidir exactamente con el nombre que viste en el paso 1 de DirectAdmin. Normalmente tiene el formato usuario_nombrebasedatos.
DB_USER: El nombre de usuario de la base de datos. También debe coincidir con el que viste en DirectAdmin. Su formato suele ser usuario_nombreusuario.
DB_PASSWORD: La contraseña de ese usuario. Asegúrate de que no tenga espacios al principio o al final. Si no la recuerdas, puedes cambiarla desde DirectAdmin (en la sección de "MySQL Management").
DB_HOST: Este valor casi siempre es localhost. En algunos hosting muy específicos puede ser una dirección IP o un nombre de servidor como mysql.tudominio.com. Si no estás seguro, déjalo como localhost.

[TIP] Si cambias la contraseña en DirectAdmin, recuerda actualizarla también en este archivo wp-config.php. Si no lo haces, el error seguirá apareciendo.

Paso 3: Comprueba que el usuario de la base de datos tenga los permisos correctos

A veces el usuario existe y la contraseña es correcta, pero no tiene permisos para acceder a la base de datos. Esto es como tener la llave correcta pero no tener permiso para abrir la puerta.

Vuelve a "Administrador de MySQL" en DirectAdmin.
Busca la opción para "Agregar usuario a la base de datos" o "Asignar usuario a la base de datos".
Selecciona tu base de datos y tu usuario. Verás una lista de permisos (SELECT, INSERT, UPDATE, DELETE, etc.).
Marca TODOS los permisos (o al menos "ALL PRIVILEGES" si existe esa opción).
Guarda los cambios.

Paso 4: Reinicia el servicio MySQL/MariaDB (si tienes acceso)

A veces el problema es que el servidor de bases de datos se ha detenido o está sobrecargado. Si tienes acceso a "Administración de Servicios" en DirectAdmin (no todos los planes lo permiten), puedes intentar reiniciarlo.

En DirectAdmin, busca "Servicios" o "Service Monitor".
Busca "mysqld" o "mariadb".
Haz clic en "Reiniciar" o "Restart". Espera unos segundos y vuelve a cargar tu web.

[WARNING] Reiniciar el servicio de base de datos puede causar una breve interrupción en todos los sitios de tu cuenta. Hazlo solo si estás seguro de que es necesario.

Paso 5: Revisa los logs de error para más detalles

Si después de los pasos anteriores el error persiste, los registros de error (logs) del servidor pueden darte pistas más precisas.

En DirectAdmin, busca "Registros de errores" o "Error Logs".
Busca la sección de "Registro de errores de MySQL" o similar.
Busca errores con la fecha y hora actuales. Pueden decir cosas como "Access denied for user" (contraseña incorrecta) o "Can't connect to MySQL server" (servidor caído).

Preguntas Frecuentes (FAQ)

¿Por qué aparece este error de repente si antes funcionaba?

Puede deberse a varias razones: un cambio de contraseña en DirectAdmin que no se reflejó en wp-config.php, una actualización de WordPress o de algún plugin que corrompió el archivo de configuración, o un problema en el servidor (caída de MySQL, límite de conexiones alcanzado).

He seguido todos los pasos y sigo sin poder acceder. ¿Qué hago?

Si has verificado credenciales, permisos y el servidor está activo, el problema podría ser más complejo: la tabla wp_options de tu base de datos podría estar corrupta. En ese caso, necesitarás reparar la base de datos. Puedes intentarlo desde phpMyAdmin (accesible desde DirectAdmin) seleccionando la base de datos y usando la opción "Reparar" (Repair). Si no te sientes cómodo, contacta con el soporte de tu hosting.

¿Puedo perder mis datos si modifico el archivo wp-config.php?

No, mientras solo edites las líneas de configuración de la base de datos (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST) y no borres otras partes del archivo. Tus posts, páginas y comentarios están en la base de datos, no en este archivo.

¿Qué es "Syspanel" y cómo se relaciona con esto?

Si tu hosting usa Syspanel (anteriormente conocido como HestiaCP), el proceso es muy similar, pero el acceso es diferente. En Syspanel, el puerto de acceso es el 2106 (por ejemplo, tudominio.com:2106). Una vez dentro, busca las secciones de "Base de datos" o "MySQL" para gestionar credenciales y usuarios. El resto de pasos (editar wp-config.php, verificar permisos) son idénticos.

Resumen rápido para solucionar el error

Identifica el problema: ¿Credenciales, permisos o servidor caído?
Verifica en DirectAdmin: Asegúrate de que la base de datos y el usuario existen.
Edita wp-config.php: Corrige el nombre, usuario y contraseña.
Asigna permisos: Dale todos los privilegios al usuario sobre la base de datos.
Reinicia MySQL (si puedes).
Revisa los logs si todo lo anterior falla.

[TIP] Siempre es buena práctica hacer una copia de seguridad de tu archivo wp-config.php antes de editarlo, por si acaso.

Con estos pasos, deberías poder recuperar tu sitio web en poco tiempo. Recuerda que la paciencia es clave. Si después de todo sigues viendo el mensaje de error, no dudes en contactar al equipo de soporte de tu hosting. Ellos tienen acceso directo a los servidores y pueden diagnosticar problemas más profundos. ¡Buena suerte y que tu web vuelva a volar!