Errores de conexión a base de datos en DirectAdmin: Soluciones

Introducción: Cuando tu web «no habla» con la base de datos

Uno de los momentos más frustrantes al gestionar un sitio web es encontrarse con un mensaje de error que dice algo como «Error al conectar con la base de datos», «Cannot connect to MySQL» o «Error establishing a database connection». Si estás usando DirectAdmin como panel de control, estos errores suelen deberse a problemas muy concretos y, lo mejor, casi siempre tienen solución en pocos pasos.

En este artículo vamos a recorrer los errores más comunes al conectar bases de datos en DirectAdmin, centrándonos especialmente en MySQL (y MariaDB). Te explicaré por qué ocurren y, paso a paso, cómo solucionarlos. No necesitas ser un experto técnico; con seguir las indicaciones podrás resolver la mayoría de incidencias.

Error 1: Credenciales incorrectas (usuario o contraseña)

Este es, con diferencia, el error más frecuente. Ocurre cuando los datos que usas en tu aplicación (CMS como WordPress, Joomla, etc.) no coinciden con los que tienes configurados en DirectAdmin.

Síntomas típicos

Mensaje: «Access denied for user ‘usuario’@’localhost’ (using password: YES)»
La web carga en blanco o muestra un error de conexión.

Causa principal

Has cambiado la contraseña de la base de datos, o al instalar la aplicación escribiste mal el usuario o la contraseña.

Solución paso a paso

Accede a DirectAdmin y ve a MySQL Management (o Base de datos MySQL).
Localiza la base de datos que usa tu sitio web. Verás el nombre de la base, el usuario asociado y un botón para cambiar la contraseña.
Cambia la contraseña por una nueva, segura, y anótala exactamente (respeta mayúsculas, minúsculas y caracteres especiales).
Ahora ve al archivo de configuración de tu aplicación (por ejemplo, wp-config.php en WordPress, configuration.php en Joomla, o .env en Laravel).
Busca las líneas donde se definen:
- DB_NAME (nombre de la base de datos)
- DB_USER (usuario)
- DB_PASSWORD (contraseña)
- DB_HOST (normalmente localhost)
Actualiza los valores con los datos correctos.
Guarda los cambios y vuelve a cargar tu web.

[TIP] Si no recuerdas dónde está el archivo de configuración, usa el Administrador de Archivos de DirectAdmin. Suele estar en la carpeta public_html o private_html.

Error 2: El host de la base de datos no es correcto

Muchos usuarios novatos ponen la IP del servidor o un dominio en lugar de localhost. En la mayoría de servidores compartidos con DirectAdmin, el host de MySQL es localhost.

Síntomas

Error: «Can’t connect to MySQL server on ‘tudominio.com’ (110)»
La web tarda mucho en cargar y luego da error.

Solución

Abre el archivo de configuración de tu aplicación.
Busca la línea DB_HOST o similar.
Cambia el valor a localhost (sin comillas).
Guarda y prueba.

[WARNING] Si tu servidor usa un puerto no estándar (por ejemplo, 3307), deberás indicarlo como localhost:3307. Pero esto es poco común en DirectAdmin estándar.

Error 3: El usuario no tiene permisos sobre la base de datos

En DirectAdmin, cada base de datos tiene usuarios asignados. Si creaste un usuario pero no lo vinculaste a la base, no podrá conectarse.

Síntomas

Error: «Access denied for user ‘usuario’@’localhost’ to database ‘basededatos’»
La aplicación no puede leer ni escribir datos.

Solución

En DirectAdmin, ve a MySQL Management.
Busca la base de datos problemática.
Haz clic en Asignar usuario o Manage Users.
Verás una lista de usuarios. Si tu usuario no aparece, selecciona el que necesitas y asígnalo con todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).
Guarda los cambios.

[INFO] Si el usuario no existe, créalo primero desde el mismo panel. DirectAdmin te permite crear usuarios y luego asignarlos a bases de datos.

Error 4: El archivo de configuración tiene caracteres ocultos o comillas incorrectas

A veces, al copiar y pegar contraseñas o nombres, se introducen caracteres invisibles (espacios, saltos de línea) o comillas tipográficas (« ») que no son válidas en PHP.

Síntomas

Error de sintaxis en el archivo de configuración.
La web muestra un error PHP en lugar del contenido.

Solución

Abre el archivo de configuración con un editor de texto plano (como el de DirectAdmin o Notepad++ en local).
Revisa que las comillas sean rectas (' o "), no curvas.
Asegúrate de que no haya espacios antes o después de los valores entre comillas.
Guarda el archivo con codificación UTF-8 sin BOM.
Sube el archivo de nuevo si lo editaste localmente.

[TIP] Si usas el Administrador de Archivos de DirectAdmin, puedes editar directamente desde el panel. Busca el archivo, haz clic derecho y elige «Edit».

Error 5: El servidor MySQL está caído o sobrecargado

Aunque menos frecuente, puede ocurrir que el servicio MySQL se haya detenido o esté saturado.

Síntomas

Error: «Can’t connect to MySQL server on ‘localhost’ (111)»
Todas las webs del servidor dan error de base de datos.

Solución (para administradores o con acceso a reseller)

Si tienes acceso root o eres reseller, puedes reiniciar MySQL desde la línea de comandos:

service mysql restart

O desde DirectAdmin como administrador:

Ve a Admin Level -> Server Management -> Services List.
Busca mysqld y haz clic en Restart.

Si eres usuario normal, contacta a tu proveedor de hosting e indícales que el servicio MySQL parece caído.

[WARNING] No intentes reiniciar servicios si no tienes permisos. Podrías causar más problemas.

Error 6: Puerto incorrecto o firewall bloqueando la conexión

En algunos servidores, el puerto de MySQL no es el 3306 estándar, o un firewall (como CSF) bloquea la conexión.

Síntomas

Error: «Can’t connect to MySQL server on ‘localhost’ (10061)»
La conexión desde aplicaciones remotas (como un gestor local) falla.

Solución

Verifica el puerto en DirectAdmin: en MySQL Management suele mostrarse.
Si es diferente, actualiza tu archivo de configuración: DB_HOST = 'localhost:3307'.
Si el problema es desde una conexión remota, asegúrate de que tu IP esté permitida en el firewall (contacta al soporte).

[INFO] En la mayoría de planes de hosting compartido, no se permite conexión remota a MySQL por seguridad. Solo desde localhost.

Error 7: Confusión con Syspanel (HestiaCP) y DirectAdmin

Algunos usuarios migran de Syspanel (anteriormente HestiaCP, cuyo puerto de acceso es el 2106) a DirectAdmin, y mezclan las configuraciones.

Síntomas

Intentas usar credenciales de Syspanel en DirectAdmin.
No encuentras las bases de datos en el mismo lugar.

Solución

En Syspanel, las bases de datos se gestionan desde la sección Base de datos del panel (puerto 2106).
En DirectAdmin, ve a MySQL Management (o Base de datos MySQL).
Las credenciales son independientes: debes crear nuevas bases y usuarios en DirectAdmin. No reutilices las de Syspanel.

[TIP] Si migraste tu web, exporta la base de datos desde Syspanel (phpMyAdmin) e impórtala en DirectAdmin. Luego actualiza el archivo de configuración con los nuevos datos.

Error 8: El nombre de la base de datos o usuario excede los límites de DirectAdmin

DirectAdmin suele añadir un prefijo al nombre de la base y del usuario (por ejemplo, usuari_database). Si tu aplicación espera un nombre diferente, fallará.

Síntomas

Error: «Unknown database ‘basededatos’»
La aplicación no encuentra la base.

Solución

En DirectAdmin, ve a MySQL Management y anota el nombre exacto de la base de datos (con el prefijo).
Actualiza ese nombre en tu archivo de configuración.
Haz lo mismo con el usuario.

[WARNING] No intentes crear bases de datos con nombres que no sigan el formato de DirectAdmin; el panel los rechazará.

Preguntas frecuentes (FAQ)

¿Por qué mi web funciona a ratos y luego da error de base de datos?

Puede ser por sobrecarga del servidor o porque el archivo de configuración tiene errores intermitentes. Revisa los logs de error en DirectAdmin (sección Error Logs) para más detalles.

¿Cómo puedo probar la conexión a MySQL desde el panel?

DirectAdmin no tiene una herramienta gráfica de prueba, pero puedes usar phpMyAdmin (accesible desde MySQL Management). Si puedes entrar, la conexión funciona.

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

En DirectAdmin, ve a MySQL Management, selecciona la base y haz clic en Change Password. Luego actualiza el archivo de configuración de tu web.

¿Puedo conectar desde una aplicación externa (como un programa de escritorio) a mi base de datos en DirectAdmin?

Normalmente no, por seguridad. Pero algunos proveedores lo permiten si activas el acceso remoto y abres el puerto en el firewall. Consulta con tu hosting.

Resumen final

Los errores de conexión a bases de datos en DirectAdmin suelen tener causas sencillas: credenciales mal escritas, host incorrecto, permisos no asignados o archivos de configuración mal formateados. Siguiendo los pasos de esta guía podrás resolver la mayoría sin necesidad de soporte técnico.

Recuerda:

Usa siempre localhost como host (salvo que tu proveedor indique lo contrario).
Verifica que el usuario esté asignado a la base de datos.
Revisa que las comillas y caracteres en el archivo de configuración sean correctos.
Si migraste desde Syspanel (puerto 2106), crea nuevas credenciales en DirectAdmin.

Y si después de todo sigues sin conexión, no dudes en contactar al soporte de tu hosting. ¡Buena suerte y a seguir construyendo tu web!