Error conexión base de datos WordPress en DirectAdmin

¿Qué significa “Error al conectar con la base de datos” en WordPress?

Cuando visitas tu sitio web y en lugar de tu página aparece un mensaje como “Error establishing a database connection” o “Error al conectar con la base de datos”, significa que WordPress no puede comunicarse con el servidor donde se almacena tu información (posts, páginas, usuarios, configuraciones).

Este es uno de los errores más comunes en WordPress y, aunque parezca dramático, tiene solución en la mayoría de los casos sin necesidad de ser un experto. En este artículo te explicaré paso a paso cómo solucionarlo cuando tu hosting está gestionado con DirectAdmin, uno de los paneles de control más utilizados en el mundo del hosting compartido y VPS.

¿Por qué ocurre este error? Causas más frecuentes

Antes de lanzarnos a modificar archivos, es importante entender qué puede estar provocando el error conexión base datos wordpress. Las causas más habituales son:

Credenciales incorrectas en el archivo wp-config.php (nombre de usuario, contraseña o nombre de base de datos mal escritos).
La base de datos no existe o fue eliminada accidentalmente.
El servidor de base de datos está caído o sobrecargado.
Permisos de usuario incorrectos (el usuario no tiene acceso a la base de datos).
Cambios en el servidor (migración, cambio de contraseña, restauración de copias).
Problemas con la IP del servidor de base de datos (si usas un host remoto).
Archivos corruptos o modificaciones incompletas en el núcleo de WordPress.

No te preocupes: vamos a revisar cada una de estas causas y te daré soluciones concretas, pensadas para usuarios de DirectAdmin.

Primeros pasos: verifica si el problema es general o solo tuyo

A veces el error no es culpa de tu configuración, sino del propio servidor. Antes de tocar nada, haz esta comprobación rápida:

Accede a tu panel de DirectAdmin (normalmente en https://tudominio.com:2222).
Si puedes entrar sin problemas, el servidor está activo.
Intenta entrar a phpMyAdmin desde DirectAdmin (sección “MySQL Management” o “Base de Datos MySQL”).
Si phpMyAdmin carga y ves tus bases de datos, el servicio MySQL está funcionando.

[INFO] Si no puedes acceder ni a DirectAdmin ni a phpMyAdmin, el problema puede ser del servidor. En ese caso, contacta con tu proveedor de hosting y diles que tienes un wordpress directadmin error de conexión a la base de datos.

Si todo funciona por tu lado, sigue leyendo.

Solución 1: Revisa el archivo `wp-config.php`

Este es el archivo más importante para la conexión. WordPress guarda ahí los datos de acceso a tu base de datos. Si algo está mal escrito, el error aparece al instante.

Cómo acceder al archivo

Puedes hacerlo de dos formas:

Opción A: Desde el administrador de archivos de DirectAdmin

Entra en DirectAdmin.
Busca la sección “Administrador de archivos” (File Manager).
Navega hasta la carpeta public_html (o la carpeta donde esté instalado WordPress).
Busca el archivo wp-config.php y haz clic derecho → Editar.

Opción B: Desde FTP

Conecta con tu cliente FTP favorito (FileZilla, por ejemplo) y descarga el archivo wp-config.php a tu ordenador. Ábrelo con un editor de texto plano (como Notepad++ o Sublime Text).

Qué debes revisar

Dentro del archivo, 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');

Comprueba que:

DB_NAME coincide exactamente con el nombre de tu base de datos en DirectAdmin.
DB_USER coincide con el usuario asignado.
DB_PASSWORD es la contraseña correcta (ojo con mayúsculas, espacios y caracteres especiales).
DB_HOST suele ser localhost, pero en algunos servidores puede ser una IP o un nombre como mysql.tudominio.com.

[WARNING] Si cambias la contraseña de la base de datos desde DirectAdmin, debes actualizar también este archivo. Es una causa muy común del error conexión base datos wordpress.

Solución 2: Verifica que la base de datos y el usuario existan en DirectAdmin

A veces, durante una migración o limpieza, se elimina la base de datos o el usuario sin darnos cuenta. Para comprobarlo:

Entra en DirectAdmin.
Ve a la sección “Gestión de Bases de Datos MySQL” (puede llamarse “MySQL Management” o “Bases de datos”).
Verás una lista con todas tus bases de datos y usuarios asignados.

Ahora, compara:

¿Existe la base de datos que aparece en tu wp-config.php?
¿Existe el usuario que aparece en DB_USER?
¿El usuario tiene permisos de TODOS LOS PRIVILEGIOS sobre esa base de datos?

Si falta algo, puedes crearlo o corregirlo desde el mismo panel:

Para crear una base de datos nueva: usa el botón “Crear base de datos”.
Para asignar un usuario a una base: selecciona la base y añade el usuario existente, marcando todos los privilegios.
Para cambiar la contraseña de un usuario: edita el usuario y establece una nueva, luego actualiza wp-config.php.

[TIP] Si no recuerdas la contraseña, puedes cambiarla desde DirectAdmin y actualizarla en wp-config.php. No la dejes vacía ni uses caracteres raros que puedan confundirte.

Solución 3: Prueba con la base de datos desde phpMyAdmin

phpMyAdmin es una herramienta que te permite ver y gestionar tus bases de datos desde el navegador. Si puedes acceder a tu base de datos desde ahí, el problema no es del servidor MySQL, sino de la configuración de WordPress.

Pasos para comprobar

En DirectAdmin, busca el icono de phpMyAdmin (suele estar en la sección de MySQL).
Accede con tu usuario y contraseña de la base de datos (no confundir con el usuario de DirectAdmin).
A la izquierda verás el listado de bases de datos. Haz clic en la tuya.
Si ves tablas (como wp_posts, wp_options, etc.), la base de datos está bien.

Si no puedes entrar con las credenciales de wp-config.php, entonces el problema es de permisos o contraseña. Vuelve a la Solución 2 y corrige.

[INFO] Si al entrar en phpMyAdmin no ves ninguna tabla, tu base de datos está vacía. Esto puede pasar tras una restauración incompleta. Tendrás que importar una copia de seguridad o reinstalar WordPress (pero eso es otro tema que no trataremos aquí).

Solución 4: Cambia el `DB_HOST` (servidor de base de datos)

En la mayoría de los casos, DB_HOST es localhost. Pero en algunos servidores, especialmente en VPS o configuraciones avanzadas, el host puede ser diferente.

Cómo saber el host correcto

Revisa el correo de bienvenida de tu hosting o la documentación.
En DirectAdmin, a veces puedes ver el host en la sección de bases de datos (algunos paneles lo muestran).
Pregunta a tu proveedor si tienes dudas.

Algunos valores alternativos que puedes probar:

127.0.0.1 (equivalente a localhost)
mysql.tudominio.com
localhost:/tmp/mysql.sock (si usas socket)

[TIP] Si tienes un hosting compartido y siempre te funcionó con localhost, no lo cambies sin necesidad. Este cambio solo es útil en casos concretos.

Solución 5: Repara la base de datos con el plugin nativo de WordPress

WordPress tiene una función oculta para reparar la base de datos. Para activarla, debes añadir una línea al archivo wp-config.php:

Abre el archivo wp-config.php como antes.
Justo antes de la línea que dice /* ¡Eso es todo, deja de editar! */, añade:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Visita esta URL en tu navegador: https://tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos botones: “Reparar base de datos” y “Reparar y optimizar base de datos”. Haz clic en el primero.
Cuando termine, elimina la línea que añadiste del wp-config.php y guarda de nuevo.

[WARNING] Es importante eliminar esa línea después de la reparación. Dejarla activa supone un riesgo de seguridad, ya que cualquiera podría acceder a esa URL.

Solución 6: Comprueba si el problema es un plugin o tema

A veces, un plugin o tema mal codificado puede provocar conflictos que rompen la conexión. Para descartarlo:

Desactiva todos los plugins: accede por FTP o File Manager y renombra la carpeta public_html/wp-content/plugins a plugins_backup.
Cambia temporalmente el tema: renombra la carpeta del tema activo dentro de public_html/wp-content/themes/ (por ejemplo, de mi-tema a mi-tema_backup). WordPress usará un tema por defecto.
Si el sitio vuelve a funcionar, reactiva plugins uno a uno para encontrar al culpable.

[INFO] Este método es muy útil cuando el error conexión base datos wordpress aparece después de instalar o actualizar algo.

Solución 7: Revisa los límites de memoria de PHP

Un límite de memoria demasiado bajo puede provocar errores extraños, incluido el de conexión. Para aumentarlo, puedes añadir esta línea en el wp-config.php:

define('WP_MEMORY_LIMIT', '256M');

También puedes modificar el archivo .htaccess (en la raíz de WordPress) añadiendo:

php_value memory_limit 256M

[TIP] Si no ves el archivo .htaccess en tu File Manager, activa la opción de “Mostrar archivos ocultos”.

Solución 8: Verifica los registros de error del servidor

DirectAdmin guarda registros de error que pueden darte pistas muy valiosas. Para acceder:

Entra en DirectAdmin.
Busca la sección “Registros de errores” o “Logs”.
Revisa los archivos de error de PHP y de MySQL.

Busca palabras como “connection refused”, “access denied”, “database does not exist”. Estas pistas te indicarán exactamente qué está fallando.

[WARNING] Si no entiendes los registros, no te preocupes. Copia el texto relevante y envíalo a tu proveedor de hosting o a un foro especializado. No compartas contraseñas ni datos sensibles.

Solución 9: Restaura una copia de seguridad reciente

Si nada de lo anterior funciona, es posible que la base de datos esté corrupta. En ese caso, la solución más rápida es restaurar una copia de seguridad.

En DirectAdmin, busca la sección de “Copias de seguridad” (Backups).
Si tienes una copia de la base de datos, restáurala.
Si no tienes copia, contacta con tu proveedor para que te ayude a restaurar una desde sus servidores.

[INFO] Si no tienes copias de seguridad, te recomiendo que actives el sistema de copias automáticas de DirectAdmin o uses un plugin como UpdraftPlus en el futuro. Esto te ahorrará muchos dolores de cabeza.

Solución 10: Contacta con tu proveedor de hosting

Si has probado todo y el error persiste, es hora de pedir ayuda profesional. Tu proveedor tiene acceso a los logs del servidor y puede verificar si hay problemas a nivel de infraestructura.

Al contactarles, incluye esta información:

El mensaje exacto del error.
Capturas de pantalla del panel de DirectAdmin.
Qué pasos ya has probado.
La fecha aproximada en que comenzó el problema.

Preguntas frecuentes (FAQ)

¿Es peligroso el error de conexión a la base de datos?

No, no es peligroso para tu información. Tus datos siguen en la base de datos, solo que WordPress no puede acceder a ellos temporalmente. Con las soluciones de esta guía, en la mayoría de los casos se resuelve en minutos.

¿Perderé mis datos si sigo estos pasos?

No, siempre que no elimines la base de datos o el usuario. Los cambios que hacemos son de configuración y permisos. Eso sí, si modificas contraseñas, asegúrate de actualizarlas también en wp-config.php.

¿Puedo prevenir este error en el futuro?

Sí, te recomiendo:

Hacer copias de seguridad periódicas.
No cambiar contraseñas de bases de datos sin actualizar wp-config.php.
Mantener WordPress, plugins y temas actualizados.
Usar solo plugins de confianza.

¿Qué pasa si mi hosting usa Syspanel en lugar de DirectAdmin?

Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es muy similar. Accede a Syspanel a través del puerto 2106 (por ejemplo, https://tudominio.com:2106) y busca la sección de bases de datos. Las soluciones de este artículo son aplicables casi al 100%.

[TIP] Tanto en DirectAdmin como en Syspanel, el archivo wp-config.php es el mismo. Los pasos de verificación de credenciales y permisos son idénticos.

Resumen final

El error conexión base datos wordpress en DirectAdmin puede parecer abrumador, pero siguiendo estos pasos ordenados, lo más probable es que lo resuelvas sin necesidad de un técnico. Recuerda:

Revisa el wp-config.php (credenciales).
Verifica que la base de datos y el usuario existan.
Prueba acceso con phpMyAdmin.
Ajusta el DB_HOST si es necesario.
Usa la reparación nativa de WordPress.
Descarta plugins y temas conflictivos.
Revisa los logs.
Restaura una copia si todo falla.
Contacta con tu proveedor.

Si has llegado hasta aquí y aún tienes dudas, no dudes en dejar un comentario o contactar con soporte. Este fix database wordpress es uno de los más demandados, y con paciencia, se soluciona.

¡Buena suerte y a recuperar tu sitio!