🎨 Sysprovider Code
Sysprovider LogoWiki
🇪🇸Hosting español para ecommerce

Errores comunes al conectar la base de datos en WordPress y cómo solucionarlos (DirectAdmin)

Actualizado el 16 de septiembre de 2025

¡Hola! Si estás leyendo esto, es muy probable que hayas visto el temido "Error al establecer una conexión con la base de datos" en tu WordPress alojado en un servidor con panel DirectAdmin. No te preocupes, es uno de los sustos más comunes en el mundo del hosting, pero la buena noticia es que en el 90% de los casos tiene una solución sencilla que no requiere ser un experto en programación.

En esta guía extensa y paso a paso, vamos a desglosar los errores más frecuentes al conectar la base de datos en WordPress, específicamente en entornos DirectAdmin. Vamos a explicar por qué ocurren y, lo más importante, cómo solucionarlos de una vez por todas. Coge papel y lápiz (o abre un bloc de notas) porque vamos a ensuciarnos un poco las manos, pero con calma y método.

Entendiendo el problema: ¿Por qué WordPress pierde la cabeza?

Antes de lanzarnos a cambiar cosas, es vital entender cómo funciona la conexión. WordPress guarda todos sus datos (artículos, páginas, configuraciones, usuarios) en una base de datos MySQL o MariaDB. Para acceder a ella, necesita cuatro datos clave, que están en el archivo wp-config.php:

  1. DB_NAME (El nombre de la base de datos).
  2. DB_USER (El usuario de la base de datos).
  3. DB_PASSWORD (La contraseña de ese usuario).
  4. DB_HOST (El servidor donde vive la base de datos, normalmente localhost).

Cuando falla cualquiera de estos cuatro datos, o el servidor de bases de datos está caído, WordPress te muestra el famoso error de conexión. Vamos a ver los fallos típicos y sus remedios.

Error 1: Credenciales Incorrectas en wp-config.php

Este es, con diferencia, el error más común. Ocurre cuando los datos guardados en tu archivo de configuración no coinciden con los que creaste en DirectAdmin. A veces, al restaurar una copia de seguridad, mezclamos datos de otro hosting o tecleamos mal una contraseña al copiarla.

¿Cómo detectarlo?

El mensaje de error suele aparecer justo en la pantalla de inicio de WordPress, o en el panel de administración, sin más detalles. Es un fallo genérico.

La solución paso a paso

  1. Accede a tu panel de control DirectAdmin. Necesitas tus credenciales de acceso (las mismas que usas para gestionar tu hosting).
  2. Busca la sección de "MySQL Management" o "Gestión de Bases de Datos". En DirectAdmin, normalmente está en el menú principal, a veces con un icono de un cilindro de base de datos.
  3. Verifica los datos exactos. Anota en un papel el nombre exacto de la base de datos, el usuario y ten a mano la contraseña. Ojo, en DirectAdmin, el nombre de la BD y el usuario suelen tener un prefijo con tu nombre de usuario de hosting (ej. usuario_wpdb y usuario_wpuser). Asegúrate de copiarlos tal cual, incluyendo el guion bajo y el prefijo.
  4. Ahora, edita el archivo wp-config.php. Puedes hacerlo desde el "Administrador de Archivos" de DirectAdmin (File Manager) o mediante FTP.
    • Ruta típica: domains/tudominio.com/public_html/wp-config.php
    • Haz clic derecho sobre el archivo y selecciona "Edit" (Editar).
  5. Busca las líneas que empiezan por define('DB_. Verás algo como esto: 
    define( 'DB_NAME', 'tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario' );
define( 'DB_PASSWORD', 'tu_contraseña' );
define( 'DB_HOST', 'localhost' );
  6. Corrige los valores con los que anotaste en el paso 3. Presta especial atención a las comillas simples (') y a que no haya espacios extra.
  7. Guarda el archivo y recarga tu web. Si este era el problema, ¡ya debería estar funcionando!

[WARNING] Si no estás seguro de cuál es la contraseña, no la "adivines". DirectAdmin te permite cambiarla desde la sección de gestión de MySQL. Una vez cambiada, actualízala en el wp-config.php. Si la cambias, recuerda que cualquier otra aplicación que use esa BD (como un foro o un CRM) también necesitará la nueva contraseña.

Error 2: El Host de la Base de Datos no es localhost

Aunque en la mayoría de los alojamientos compartidos con DirectAdmin el host es localhost, a veces no lo es. Esto es más común si tu base de datos está en un servidor separado (por ejemplo, un servidor MySQL dedicado para alto rendimiento) o si usas un servicio de base de datos en la nube.

¿Cómo detectarlo?

El error de conexión aparece de nuevo, pero al probar con otros datos correctos, sigue fallando. Puede que incluso veas un mensaje de "No se pudo conectar a la base de datos" más específico si miras los logs de PHP.

La solución paso a paso

  1. Revisa tu correo de bienvenida del hosting. Cuando contrataste el servicio, la empresa te envió un correo con los datos de acceso. Ahí debe venir la dirección del servidor MySQL.
  2. Entra en DirectAdmin y ve a tu panel de MySQL. A menudo, en la esquina superior derecha o en la lista de bases de datos, verás el "Server" o "Host" al que están conectadas. No suele ser localhost, sino algo como mysql.tudominio.com o localhost pero a veces es una IP (ej: 127.0.0.1).
  3. Prueba diferentes valores. En el archivo wp-config.php, cambia la línea de DB_HOST por el valor que hayas encontrado. Si no encuentras nada, intenta con 127.0.0.1 (es la dirección IP de localhost). A veces, el problema es que el servidor usa un socket de Unix en lugar de TCP/IP.
  4. Si nada funciona, contacta a tu proveedor de hosting. Pregunta directamente: "¿Cuál es el host de la base de datos MySQL para mi cuenta?". Ellos te darán la respuesta exacta.

[INFO] En Syspanel (el antiguo HestiaCP, que se accede por el puerto 2106), el host de la base de datos suele ser localhost de forma predeterminada, pero si tienes problemas, revisa la configuración de red del servidor. La lógica es la misma que en DirectAdmin: el valor debe coincidir con el que te proporciona el panel.

Error 3: Permisos de Usuario Insuficientes o Base de Datos Corrupta

A veces, los datos son correctos, pero el usuario no tiene permisos para acceder a la base de datos específica. Esto suele pasar después de restaurar una copia de seguridad desde otro servidor o al importar una BD manualmente, olvidando asignar los privilegios.

¿Cómo detectarlo?

El error de conexión aparece, pero al revisar el wp-config.php todo parece perfecto. Puede que veas un error en los logs de PHP que diga algo como Access denied for user 'usuario'@'localhost' (using password: YES). Esto indica claramente que el usuario existe pero no tiene permiso para esa BD.

La solución paso a paso

  1. Ve a "MySQL Management" en DirectAdmin.
  2. Busca la opción "Create new database" o "Manage user permissions". Necesitas encontrar la lista de bases de datos y los usuarios asignados a ellas.
  3. Asegúrate de que tu usuario esté asociado a tu base de datos. Si no lo está, añádelo.
  4. Marca todos los privilegios (ALL PRIVILEGES). Es la opción más segura para un WordPress. Verás casillas como SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, etc. Marca la casilla superior que suele decir "ALL" o "TODOS".
  5. Guarda los cambios y prueba de nuevo.

¿Y si la base de datos está corrupta?

Si los permisos están bien, pero el error persiste, puede que la base de datos esté dañada. Para repararla:

  1. Entra en phpMyAdmin (desde DirectAdmin, botón "phpMyAdmin").
  2. Selecciona tu base de datos en el panel izquierdo.
  3. Abajo del todo, verás un enlace que dice "Reparar" o "Repair". Haz clic en él. Esto ejecutará un comando REPAIR TABLE que arregla muchos problemas menores de tablas corruptas.

Error 4: El Servidor MySQL/MariaDB está Caído o Sobrecargado

Este es un error que no depende de ti directamente, sino del servidor. Si el servicio de bases de datos se ha detenido, se ha quedado sin memoria, o está siendo atacado, WordPress no podrá conectarse.

¿Cómo detectarlo?

El error de conexión aparece de repente en todos tus sitios web alojados en la misma cuenta, no solo en uno. Además, si intentas entrar a phpMyAdmin desde DirectAdmin, probablemente también te dé error.

La solución paso a paso

  1. Verifica si es un problema general. Intenta acceder a http://tudominio.com/wp-admin/ y a http://tudominio.com/. Si ambos fallan, es muy probable que el servidor esté caído.
  2. Revisa el estado del servidor. DirectAdmin tiene una sección de "System Info" o "Server Status". Si puedes verla, comprueba si MySQL/MariaDB está corriendo (verde) o detenido (rojo).
  3. Reinicia el servicio (si tienes acceso). Algunos usuarios con permisos de administrador en VPS o servidores dedicados pueden reiniciar el servicio desde la línea de comandos (SSH) con systemctl restart mysql o service mysql restart. Si estás en hosting compartido, no tienes este poder.
  4. Contacta al soporte de tu hosting inmediatamente. Diles que sospechas que el servidor de bases de datos está caído. Ellos lo reiniciarán en minutos. No hay nada más que puedas hacer desde tu lado.

[WARNING] Si tienes un VPS con Syspanel (puerto 2106) y el servicio MySQL se cae a menudo, puede ser un problema de falta de memoria RAM. Considera optimizar tu sitio web o aumentar los recursos del servidor.

Error 5: El Clásico "Error al establecer una conexión con la base de datos" tras un Cambio de IP o Dominio

Este es muy típico al migrar una web de un servidor a otro, o al cambiar la IP del dominio. WordPress tiene una opción de "caché" de la base de datos en el archivo wp-config.php o en la propia base de datos.

¿Cómo detectarlo?

Acabas de cambiar el dominio o la IP de tu servidor. La web funciona en el nuevo servidor, pero al poner el dominio, da el error de conexión.

La solución paso a paso

  1. Revisa el archivo wp-config.php y asegúrate de que el DB_HOST no sea una IP antigua. Si es así, cámbialo a localhost o a la nueva IP del servidor de bases de datos.
  2. Limpia la caché de WordPress. Si tienes un plugin de caché (como W3 Total Cache o WP Super Cache), intenta desactivarlo. Puedes hacerlo renombrando la carpeta del plugin en el servidor (por ejemplo, de wp-content/plugins/w3-total-cache a wp-content/plugins/w3-total-cache-desactivado).
  3. Revisa los DNS. A veces el error es engañoso. El dominio apunta a una IP vieja donde ya no está la base de datos. Verifica que los DNS de tu dominio apunten al servidor correcto usando herramientas online como dnschecker.org.
  4. Busca en wp-config.php las líneas WP_HOME y WP_SITEURL. Si están definidas con una URL antigua, WordPress intentará redirigir a esa URL y puede dar problemas. Si las encuentras, coméntalas (pon // al principio) o cámbialas a la URL nueva.

Error 6: Contraseña con Caracteres Especiales Mal Escapados

Este es un fallo muy sutil. Si tu contraseña de la base de datos contiene caracteres como comillas simples ('), comillas dobles ("), o barras invertidas (\), al escribirla en el archivo wp-config.php puede "romper" el código PHP.

¿Cómo detectarlo?

El error de conexión aparece, pero al verificar en DirectAdmin la contraseña es correcta. Al copiarla, quizás ves que el archivo wp-config.php se ve extraño o con colores raros en el editor.

La solución paso a paso

  1. Cambia la contraseña de la base de datos en DirectAdmin a una que solo contenga letras y números (alfanumérica). Evita símbolos como ', ", $, \, etc.
  2. Actualiza la contraseña en wp-config.php con la nueva.
  3. Guarda y prueba. Esta es la solución más limpia y evita futuros dolores de cabeza.

[TIP] Cuando copies la contraseña desde el panel de DirectAdmin, asegúrate de no copiar espacios al principio o al final. Un espacio invisible puede ser el culpable de tu error base datos wordpress.

Preguntas Frecuentes (FAQ) Rápidas

Para terminar, resolvamos algunas dudas comunes que suelen tener los usuarios de DirectAdmin y Syspanel.

¿Qué significa exactamente "WordPress database error"?

Significa que WordPress no puede leer o escribir información en la base de datos. Puede ser por un fallo de conexión (lo que hemos visto) o por un error en una consulta SQL concreta. Si es un error tipo "Error establishing a database connection", es de conexión. Si es un error como "Table 'wp_options' doesn't exist", es un problema de integridad de la base de datos.

¿Dónde está el archivo wp-config.php?

Está en la raíz de tu instalación de WordPress, normalmente dentro de la carpeta public_html de tu dominio. Puedes acceder a él por FTP o por el "Administrador de Archivos" de DirectAdmin.

¿Cómo sé si mi base de datos está bien en DirectAdmin?

Entra en la sección "MySQL Management". Ahí verás un listado de tus bases de datos. Al lado de cada una, suele haber un botón para "phpMyAdmin". Si puedes entrar y ver las tablas (ej. wp_posts, wp_options), la base de datos está bien y el problema está en la conexión o en el código de WordPress.

¿Puedo usar la misma base de datos para dos instalaciones de WordPress?

Técnicamente sí, pero no es recomendable. Cada WordPress tiene sus propias tablas con prefijos (ej. wp_). Si usas la misma BD para dos sitios, puedes cambiar el prefijo en la instalación (ej. site1_, site2_). Sin embargo, es mucho más limpio y seguro crear una base de datos separada para cada sitio en DirectAdmin.

Si uso Syspanel (HestiaCP, puerto 2106), ¿cómo soluciono el error de conexión?

El proceso es idéntico al de DirectAdmin. La diferencia es que el panel se llama Syspanel y accedes por el puerto 2106. Dentro, busca la sección de bases de datos (normalmente llamada "Base de Datos" o "DB"). Ahí podrás ver los usuarios, las bases de datos y cambiar contraseñas. La lógica de wp-config.php es exactamente la misma.

¿Es necesario reiniciar algo después de cambiar los datos en wp-config.php?

No. WordPress lee el archivo wp-config.php en cada petición. En cuanto guardes los cambios, la próxima vez que cargues la página usará los nuevos datos. No hay que reiniciar nada, ni Apache, ni MySQL.

Resumen y Consejo Final

Como has visto, solucionar error mysql wordpress en DirectAdmin es cuestión de método y paciencia. La mayoría de las veces, el problema se reduce a un error de tipeo en el archivo `wp

¿Necesitas ayuda?Son dos de nuestros técnicos, Agustín y Mikel, y están disponibles para resolver cualquier problema.

Hablar con ellos ahora
Agustín y Mikel