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

Guía para solucionar el error 'Conexión a base de datos' en WordPress con DirectAdmin

Actualizado el 22 de junio de 2026

¡Hola! Soy tu técnico de soporte amigable. ¿Te ha aparecido un mensaje de error en tu web WordPress que dice algo como "Error al establecer una conexión a la base de datos" o "Error de conexión a la base de datos"? No te preocupes, es uno de los errores más comunes, pero también de los más fáciles de solucionar si sigues los pasos adecuados.

En esta guía completa y muy visual, te voy a explicar paso a paso cómo solucionar este problema cuando tu WordPress está alojado en un servidor que usa DirectAdmin (o su versión mejorada Syspanel). Vamos a ir desde lo más básico hasta soluciones más avanzadas, pero siempre con un lenguaje muy sencillo.

[INFO] Este artículo está diseñado para usuarios sin experiencia técnica. Si sigues los pasos al pie de la letra, tendrás tu web funcionando en pocos minutos.

¿Qué significa el error "Conexión a base de datos" en WordPress?

Cuando ves el mensaje "Error al establecer una conexión a la base de datos" en tu pantalla, significa que WordPress no puede comunicarse con la base de datos donde se almacenan tus artículos, páginas, usuarios y configuraciones. Sin esa conexión, tu web no puede cargar nada.

Las causas más comunes son:

  • Credenciales incorrectas: El archivo wp-config.php tiene el nombre de usuario, contraseña o nombre de la base de datos equivocados.
  • Base de datos caída o corrupta: El servidor de bases de datos (MySQL/MariaDB) puede estar detenido o tener algún problema.
  • Problemas de permisos: El usuario de la base de datos no tiene permiso para acceder a ella.
  • Archivo wp-config.php dañado: Este archivo es el "mapa" de conexión de WordPress. Si está mal escrito o tiene caracteres extraños, la conexión falla.
  • Cambios en el hosting: Si has migrado tu web o el proveedor ha cambiado algo, las credenciales pueden haber cambiado.

[WARNING] No entres en pánico. Este error no borra tu contenido. Toda tu información (artículos, imágenes, etc.) sigue en la base de datos. Solo necesitas reconectar el "cable" que los une.

Paso 1: Accede a tu panel de control (DirectAdmin o Syspanel)

Lo primero es acceder al panel de control de tu hosting. Dependiendo de tu proveedor, puede ser DirectAdmin o Syspanel (que es una versión moderna de HestiaCP).

Para DirectAdmin:

  1. Abre tu navegador y escribe: https://tudominio.com:2222 (reemplaza "tudominio.com" por tu dominio real).
  2. Introduce tu usuario y contraseña de hosting (los que te dio tu proveedor, no los de WordPress).

Para Syspanel (HestiaCP):

  1. Abre tu navegador y escribe: https://tudominio.com:2106 (puerto 2106, recuerda).
  2. Introduce tu usuario y contraseña de hosting.

[TIP] Si no recuerdas tus credenciales, busca el correo de bienvenida de tu hosting o contacta con el soporte técnico.

Paso 2: Encuentra el archivo wp-config.php

El archivo wp-config.php es el que tiene las instrucciones para conectar con la base de datos. Está en la raíz de tu instalación de WordPress.

  1. Dentro de DirectAdmin o Syspanel, busca la sección "Administrador de archivos" (File Manager). Suele ser un icono de una carpeta.
  2. Navega hasta la carpeta donde tienes instalado WordPress. Normalmente es public_html o public_html/tu-carpeta.
  3. Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona "Editar" o "View/Edit".

[WARNING] No borres ni modifiques nada más que las líneas que te indicaré. Si tienes dudas, haz una copia de seguridad del archivo antes de editarlo (puedes descargarlo a tu PC o copiar su contenido en un bloc de notas).

Paso 3: Verifica las credenciales de la base de datos

Dentro del archivo wp-config.php, busca las líneas que empiezan así:

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

Estas son las cuatro "llaves" de la conexión. Deben coincidir exactamente con los datos de tu base de datos. Si alguna es incorrecta, WordPress no podrá conectarse.

¿Cómo obtener los datos correctos?

  1. DirectAdmin: Ve a la sección "MySQL Management" o "Bases de datos MySQL". Allí verás una lista con tus bases de datos. Anota el nombre de la base de datos, el usuario y haz clic en "Editar" o "Change Password" para ver o cambiar la contraseña.
  2. Syspanel: Ve a la sección "Bases de datos" o "Databases". Verás la misma información. Puedes generar una nueva contraseña si no la recuerdas.

[TIP] A veces el nombre de la base de datos o el usuario tiene un prefijo, como tuusuario_nombrebasededatos. Asegúrate de copiarlo exactamente como aparece en el panel.

¿Qué hacer si los datos no coinciden?

  • Opción A: Edita el archivo wp-config.php y reemplaza 'nombre_base_datos', 'usuario_base_datos' y 'contraseña_base_datos' con los valores correctos de tu panel.
  • Opción B: Si prefieres cambiar la contraseña de la base de datos desde el panel para que coincida con la que tienes en wp-config.php, también funciona.

[WARNING] El campo DB_HOST casi siempre es 'localhost'. Si tu proveedor usa un host remoto, te lo habrán indicado. No lo cambies a menos que estés seguro.

Guarda los cambios en el archivo wp-config.php y recarga tu web. Si el error persiste, sigue al siguiente paso.

Paso 4: Verifica que la base de datos esté funcionando correctamente

A veces el problema no son las credenciales, sino que el servidor de bases de datos (MySQL) está caído o sobrecargado.

Para DirectAdmin:

  1. Ve a la sección "System Info & Files" y luego a "Process Manager" o "Services".
  2. Busca el servicio llamado "mysqld" o "mariadb". Debe aparecer como "Running" (en ejecución).

Para Syspanel:

  1. Ve a "Ajustes" > "Servicios".
  2. Busca "MySQL" o "MariaDB". Su estado debe ser "Activo".

Si no está activo:

  • Haz clic en "Iniciar" o "Reiniciar" el servicio.
  • Espera unos segundos y vuelve a cargar tu web.

[INFO] Si el servicio se detiene constantemente, contacta con tu proveedor de hosting, ya que puede ser un problema de recursos del servidor.

Paso 5: Repara la base de datos (si está corrupta)

Si los pasos anteriores no funcionan, la base de datos podría estar corrupta. WordPress tiene una herramienta oculta para repararla.

  1. Abre el archivo wp-config.php de nuevo (como en el Paso 2).

  2. Justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */, añade esta línea:

    define('WP_ALLOW_REPAIR', true);

  3. Guarda el archivo.

  4. Abre una nueva pestaña en tu navegador y ve a esta dirección: https://tudominio.com/wp-admin/maint/repair.php

    [WARNING] Si tu web está en una subcarpeta, la URL sería algo como: https://tudominio.com/carpeta/wp-admin/maint/repair.php

  5. Verás una pantalla con dos opciones:

    • "Repair Database" (Reparar base de datos)
    • "Repair and Optimize Database" (Reparar y optimizar base de datos)

    Haz clic en "Repair Database". El proceso puede tardar unos segundos. Verás un mensaje de éxito si todo va bien.

  6. Una vez terminado, vuelve a editar el archivo wp-config.php y elimina la línea que añadiste (define('WP_ALLOW_REPAIR', true);). Si la dejas, cualquiera podría acceder a la herramienta de reparación.

  7. Recarga tu web. ¡Debería funcionar!

Paso 6: Soluciones avanzadas (si nada funciona)

Si después de todo lo anterior el error error conexión base datos WordPress sigue apareciendo, prueba estas opciones:

1. Restaura una copia de seguridad del wp-config.php

Si tienes una copia de seguridad reciente de tu web, restaura el archivo wp-config.php original. A veces, al editar, se pueden introducir errores.

2. Crea un nuevo usuario de base de datos

A veces el usuario tiene permisos dañados. Desde DirectAdmin o Syspanel:

  • Crea un nuevo usuario para la base de datos.
  • Asígnale todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).
  • Actualiza el archivo wp-config.php con el nuevo usuario y contraseña.

3. Verifica el archivo .htaccess

Un archivo .htaccess corrupto puede causar problemas. Renómbralo a .htaccess_old desde el administrador de archivos. Luego, ve a tu panel de WordPress (si logras acceder) y ve a Ajustes > Enlaces permanentes y haz clic en Guardar cambios para regenerarlo.

4. Contacta con tu proveedor de hosting

Si nada de esto funciona, el problema puede ser del servidor (firewall, IP bloqueada, etc.). Ellos pueden verificar los logs y solucionarlo.

Preguntas Frecuentes (FAQ)

¿Por qué me aparece este error después de migrar mi web?

Es muy común. Al migrar, las credenciales de la base de datos suelen cambiar. Solo necesitas actualizar el archivo wp-config.php con los nuevos datos de tu nuevo hosting.

¿El error borra mis datos?

No, de ninguna manera. El error solo impide que WordPress muestre la información. Tus artículos, imágenes y configuraciones están seguras en la base de datos.

¿Puedo solucionarlo desde el móvil?

Sí, si tienes acceso a tu panel de control (DirectAdmin o Syspanel) desde el navegador del móvil, puedes editar el archivo wp-config.php sin problema.

¿Qué hago si no encuentro el archivo wp-config.php?

Puede que esté oculto. En el administrador de archivos, busca una opción que diga "Mostrar archivos ocultos" (Show Hidden Files). También puedes crearlo desde cero usando la herramienta de instalación de WordPress, pero es más complejo.

¿Cuánto tiempo debo esperar después de reparar la base de datos?

El proceso de reparación es casi instantáneo. Después de eliminar la línea de reparación, recarga tu web inmediatamente.

Conclusión

El error conexión base datos WordPress es frustrante, pero casi siempre tiene una solución sencilla. Recuerda los pasos clave:

  1. Verifica las credenciales en wp-config.php.
  2. Comprueba que la base de datos esté activa en tu panel.
  3. Repara la base de datos si es necesario.
  4. Actualiza o restaura el archivo de configuración.

Si has llegado hasta aquí y sigues con problemas, no dudes en contactar con el soporte de tu hosting. Ellos tienen acceso directo a los logs del servidor y pueden ayudarte en minutos.

[TIP] Para evitar este error en el futuro, siempre guarda una copia de seguridad de tu archivo wp-config.php y de tu base de datos. ¡La prevención es la mejor solución!

Espero que esta guía te haya sido de gran ayuda. ¡Tu web volverá a estar online en un abrir y cerrar de ojos!

¿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