Error de conexión a base de datos WordPress: Solución definitiva

¿Qué significa “Error de conexión a la base de datos” en WordPress?

Cuando intentas acceder a tu sitio web y ves el mensaje “Error al establecer una conexión con la base de datos”, no significa que tu web haya desaparecido. Simplemente, WordPress no puede comunicarse con el servidor donde se guardan tus contenidos, usuarios y configuraciones. Es uno de los fallos más comunes y, por suerte, casi siempre tiene solución en unos pocos minutos.

Este error puede aparecer por muchas razones: desde un cambio de contraseña en el panel de hosting, hasta un ataque o un fallo del servidor. Lo importante es que no entres en pánico. A continuación, te explicamos paso a paso cómo diagnosticar y solucionar el error de conexión a la base de datos en WordPress, ya sea que uses cPanel, Plesk o DirectAdmin.

Primeros pasos: antes de tocar nada

Antes de entrar en archivos técnicos, haz una comprobación rápida. A veces el problema es tan simple como que el servidor está en mantenimiento o que tu proveedor de hosting está realizando una actualización.

Revisa si otros sitios en el mismo hosting funcionan. Si tienes más webs, míralas. Si ninguna carga, el problema es del servidor, no de tu WordPress.
Prueba a entrar en el panel de administración de tu hosting (cPanel, Plesk o DirectAdmin). Si tampoco puedes acceder, espera unos minutos y vuelve a intentarlo.
Verifica el estado del servicio de base de datos (MySQL/MariaDB). En cPanel, por ejemplo, hay una sección llamada “Estado de MySQL” o similar. Si aparece en rojo, el servidor de base de datos está caído.

[INFO] Si el servidor de bases de datos está caído, no hay nada que puedas hacer desde tu lado. Contacta con tu proveedor de hosting y espera a que lo restablezcan.

Si todo parece normal en el servidor, entonces el problema está en la configuración de tu WordPress. Vamos a por ello.

Solución 1: Revisa el archivo wp-config.php (la causa más frecuente)

El archivo wp-config.php es el corazón de la configuración de tu WordPress. Contiene los datos de acceso a la base de datos. Si algo está mal aquí, WordPress no puede conectarse.

¿Cómo acceder al archivo?

cPanel: Entra en el Administrador de archivos, navega hasta la carpeta public_html (o la raíz de tu sitio) y busca wp-config.php.
Plesk: Ve a Sitios web y dominios, entra en tu dominio, y en la sección de Archivos busca el archivo.
DirectAdmin: Usa el Administrador de archivos y ve a la carpeta domains/tudominio.com/public_html.

¿Qué debes comprobar?

Dentro del archivo, busca estas líneas (normalmente están al principio):

define('DB_NAME', 'tu_base_de_datos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Comprueba que los valores coincidan con los datos reales de tu base de datos. Si no los recuerdas, puedes encontrarlos en tu panel de hosting:

En cPanel: Busca la sección Bases de datos MySQL. Ahí verás el nombre de la base, el usuario y la opción de cambiar la contraseña.
En Plesk: Ve a Bases de datos en el panel de tu dominio.
En DirectAdmin: Entra en Administración de MySQL.

[WARNING] Si usas Syspanel (antes conocido como HestiaCP), el acceso al panel es a través del puerto 2106 (por ejemplo, https://tudominio.com:2106). Allí encontrarás la sección de bases de datos MySQL con todos los datos.

¿Qué hacer si los datos no coinciden?

Copia el nombre exacto de la base de datos y el usuario (a veces tienen prefijos como tuusuario_).
Si cambiaste la contraseña recientemente, actualízala también en el wp-config.php.
Guarda el archivo y recarga tu web.

[TIP] Si no tienes acceso al archivo por FTP o administrador de archivos, puedes usar el phpMyAdmin desde tu panel de hosting para ver los nombres de las bases de datos.

Solución 2: Repara la base de datos con la herramienta de WordPress

WordPress tiene una función oculta para reparar bases de datos. Es muy útil si el error aparece por tablas corruptas o dañadas.

Pasos para activarla:

Abre tu archivo wp-config.php.
Busca la línea que dice:

define('WP_DEBUG', false);

Justo debajo, añade esta línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ve a esta URL en tu navegador: https://tudominio.com/wp-admin/maint/repair.php

Verás una pantalla con dos opciones. Haz clic en “Reparar base de datos”. WordPress intentará arreglar las tablas dañadas.

Cuando termine, elimina la línea que añadiste en el wp-config.php para evitar que cualquiera pueda acceder a esa herramienta.

[WARNING] No dejes la línea WP_ALLOW_REPAIR activa. Es un agujero de seguridad. Úsala solo para la reparación y luego quítala.

Solución 3: Comprueba el puerto y el host de la base de datos

A veces el error no está en los datos, sino en el host de la base de datos. Muchos servidores usan localhost, pero otros usan una dirección IP o un nombre de servidor específico.

¿Cómo saber cuál es el host correcto?

cPanel: Normalmente es localhost, pero algunos hosts usan 127.0.0.1 o el nombre de tu servidor (por ejemplo, mysql.tudominio.com).
Plesk: Puede ser localhost o 127.0.0.1, pero algunos servidores usan un socket específico.
DirectAdmin: Igual que los anteriores, suele ser localhost.

Si no estás seguro, mira la documentación de tu proveedor o contacta con su soporte. A veces el host aparece en el propio panel, en la sección de bases de datos.

[INFO] Si tu hosting usa Syspanel, el host suele ser localhost, pero verifica en la sección de bases de datos del panel (puerto 2106) si aparece algún dato diferente.

Solución 4: Revisa si el servidor de bases de datos está sobrecargado

Aunque tu web esté bien configurada, si el servidor de bases de datos está saturado, WordPress no podrá conectarse. Esto es más común en hosting compartidos.

Señales de sobrecarga:

El error aparece y desaparece.
Otros sitios en el mismo servidor también fallan.
El panel de hosting funciona lento.

Qué puedes hacer:

Espera unos minutos y recarga la página.
Contacta con tu proveedor para que verifique el estado del servidor.
Si es un problema recurrente, considera cambiar a un plan superior o a un servidor dedicado.

[TIP] Activa un sistema de caché (como W3 Total Cache o WP Super Cache) para reducir la carga en la base de datos y evitar estos fallos en el futuro.

Solución 5: Restaura una copia de seguridad

Si has intentado todo y nada funciona, puede que la base de datos esté corrupta de forma grave. En ese caso, la solución más rápida es restaurar una copia de seguridad reciente.

Pasos para restaurar:

Entra en tu panel de hosting y busca la sección de copias de seguridad (Backups).
Busca la copia más reciente de tu base de datos.
Restaura esa copia en la misma base de datos (o crea una nueva base y actualiza el wp-config.php).

[WARNING] Al restaurar, perderás los cambios realizados desde la copia de seguridad. Asegúrate de tener una copia reciente (idealmente de las últimas 24 horas).

Solución 6: Comprueba los permisos de usuario de la base de datos

A veces el usuario de la base de datos no tiene todos los permisos necesarios. WordPress necesita permisos de SELECT, INSERT, UPDATE, DELETE (y a veces más) sobre las tablas de la base.

Cómo comprobarlo en cPanel:

Ve a Bases de datos MySQL.
Busca tu base de datos y el usuario asociado.
Haz clic en “Administrar privilegios” (o similar) y asegúrate de que están marcadas todas las casillas (o al menos las básicas).

En Plesk y DirectAdmin:

Entra en la sección de Bases de datos y busca la opción de usuarios y privilegios.
Asegúrate de que el usuario tiene todos los privilegios sobre la base de datos.

[INFO] Si no sabes qué permisos marcar, selecciona “Todos los privilegios”. Es lo más seguro para WordPress.

Solución 7: Verifica si hay un plugin o tema que causa el error

A veces, un plugin o tema mal configurado puede modificar la conexión a la base de datos o causar conflictos. Esto es más raro, pero puede pasar.

Cómo comprobarlo:

Desactiva todos los plugins. Puedes hacerlo desde el panel de administración (si puedes acceder) o renombrando la carpeta wp-content/plugins a wp-content/plugins_off desde el administrador de archivos.
Cambia a un tema por defecto (como Twenty Twenty-Four). Puedes hacerlo renombrando la carpeta de tu tema activo en wp-content/themes.

Si el error desaparece, reactiva los plugins uno a uno para encontrar al culpable.

[TIP] Si no puedes acceder al panel de administración, usa el administrador de archivos de tu hosting para renombrar las carpetas. Es seguro y reversible.

Solución 8: Contacta con tu proveedor de hosting

Si después de todos estos pasos el error de conexión a la base de datos en WordPress persiste, es hora de pedir ayuda profesional. Tu proveedor de hosting puede:

Comprobar los logs del servidor.
Verificar si hay bloqueos de IP o firewalls.
Reiniciar el servicio de MySQL/MariaDB.
Diagnosticar problemas de hardware o configuración.

[WARNING] No intentes modificar los archivos de configuración del servidor si no sabes lo que haces. Podrías empeorar las cosas.

Preguntas frecuentes (FAQ)

¿Qué significa “Error al establecer una conexión con la base de datos”?

Significa que WordPress no puede comunicarse con el servidor MySQL donde se guarda tu información. Es un problema de configuración, permisos o del propio servidor.

¿Cuánto tiempo se tarda en solucionar?

En la mayoría de los casos, entre 5 y 15 minutos si el problema es de configuración. Si el servidor está caído, dependerá de tu proveedor.

¿Perderé mis datos si restauro una copia de seguridad?

Solo perderás los datos que hayas añadido o modificado después de la copia. Si tu última copia es de hace horas, apenas perderás nada.

¿Puedo prevenir este error?

Sí, con estas buenas prácticas:

Realiza copias de seguridad semanales.
Actualiza WordPress, plugins y temas regularmente.
Usa un plugin de caché para reducir la carga.
No cambies la contraseña de la base de datos sin actualizar wp-config.php.

¿Syspanel es lo mismo que HestiaCP?

Sí, Syspanel es el nuevo nombre de HestiaCP. Si tu hosting usa este panel, recuerda que el acceso es a través del puerto 2106 (por ejemplo, https://tudominio.com:2106).

Resumen final: qué hacer paso a paso

Si te encuentras con el error de conexión a la base de datos en WordPress, sigue este orden:

Comprueba el estado del servidor en tu panel de hosting.
Revisa el archivo wp-config.php y verifica los datos de conexión.
Usa la herramienta de reparación de WordPress.
Verifica el host y puerto de la base de datos.
Comprueba los permisos del usuario.
Desactiva plugins y temas si sospechas de un conflicto.
Restaura una copia de seguridad si nada funciona.
Contacta con tu proveedor como último recurso.

Con estos pasos, en el 99% de los casos podrás solucionar el error de WordPress y recuperar tu sitio web. Recuerda: la paciencia y la revisión metódica son tus mejores aliadas. ¡No te rindas!