Solucionar error de conexión a base de datos en WordPress

¿Qué significa exactamente el error "Error establishing a database connection"?

Este es uno de los avisos más temidos por cualquier persona que administra un sitio en WordPress. Cuando lo ves en pantalla, significa que tu sitio web no puede comunicarse con la base de datos donde se guardan tus entradas, páginas, comentarios y configuración. Sin esa conexión, WordPress no puede generar las páginas que visitan tus usuarios.

Lo primero que debes saber es que este error no es sinónimo de que hayas perdido tu contenido. La información sigue ahí, en la base de datos. Simplemente hay un problema de comunicación entre tu WordPress y el servidor de bases de datos (normalmente MySQL o MariaDB). La buena noticia es que, en la mayoría de los casos, tiene una solución sencilla que puedes aplicar tú mismo sin necesidad de ser un experto.

A lo largo de esta guía, te explicaré paso a paso cómo diagnosticar y solucionar el error conexión base de datos WordPress, independientemente de si tu hosting usa cPanel, Plesk o DirectAdmin. También te daré consejos para evitar que vuelva a ocurrir. No te preocupes si no tienes experiencia técnica: iremos despacio y con instrucciones muy claras.

Paso 1: Comprueba si el problema es general o solo de tu sitio

Antes de tocar nada, es importante que determines el alcance del problema. Esto te ahorrará mucho tiempo.

Prueba con la página de administración

Intenta acceder a tu panel de administración de WordPress. Normalmente está en una dirección como tudominio.com/wp-admin o tudominio.com/wp-login.php.

Si también te da error, el problema es general.
Si puedes entrar al panel, es posible que el error solo aparezca en la parte pública del sitio.

Revisa si otros sitios en tu mismo hosting funcionan

Si tienes más de un sitio web en el mismo plan de hosting, visita uno de ellos. Si también falla, es muy probable que el problema esté en el servidor, no en tu instalación de WordPress. En ese caso, contacta con tu proveedor de hosting de inmediato, ya que puede ser un fallo del servidor de bases de datos o un mantenimiento programado.

Paso 2: Verifica los datos de conexión en tu archivo wp-config.php

La causa más común del database connection error WordPress es que los datos de acceso a la base de datos hayan cambiado o sean incorrectos. Estos datos se guardan en un archivo llamado wp-config.php, que se encuentra en la carpeta raíz de tu instalación de WordPress.

Cómo acceder al archivo wp-config.php

Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de control. Te explico con el administrador de archivos, que es más sencillo:

Entra en tu panel de hosting (cPanel, Plesk o DirectAdmin).
Busca la sección "Administrador de archivos" o "Gestor de archivos".
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o htdocs).
Localiza el archivo wp-config.php. Si no lo ves, activa la opción de "mostrar archivos ocultos".

Qué debes revisar dentro del archivo

Abre el archivo con un editor de texto (el propio administrador de archivos suele tener uno). Busca las líneas que empiezan por DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. Deben tener este aspecto:

define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Comprueba que estos valores coinciden exactamente con los que te proporcionó tu empresa de hosting. Un error muy típico es que la contraseña contenga caracteres especiales y se haya copiado mal, o que el nombre de la base de datos incluya un prefijo que no has añadido.

[WARNING] Si has cambiado recientemente la contraseña de tu base de datos desde el panel de control, debes actualizarla también aquí. Si no lo haces, WordPress no podrá conectarse y verás el error.

Paso 3: Revisa el estado de tu base de datos desde el panel de control

Si los datos son correctos, el siguiente paso es verificar que la base de datos existe y está activa. Para ello, usa el panel de control de tu hosting.

En cPanel

Busca la sección "Bases de datos MySQL".
Verás un listado con tus bases de datos y usuarios. Comprueba que la base de datos que usa WordPress aparece en la lista.
Asegúrate de que el usuario de la base de datos está vinculado a esa base de datos y tiene todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.).

En Plesk

Ve a "Sitios web y dominios".
Busca tu dominio y haz clic en "Bases de datos".
Comprueba que tu base de datos está ahí. Plesk suele mostrar el usuario y el estado (activo/inactivo).

En DirectAdmin

Accede a "MySQL Management" o "Administración de MySQL".
Revisa que tu base de datos existe y que el usuario tiene permisos.

Si la base de datos no aparece, es posible que se haya eliminado por error. En ese caso, necesitarás contactar con tu proveedor para intentar restaurarla desde una copia de seguridad.

Paso 4: El problema del host de la base de datos (DB_HOST)

El valor de DB_HOST no siempre es localhost. En muchos hostings compartidos, especialmente si usas cPanel, el host de la base de datos es una dirección interna como mysql.tudominio.com o localhost:3306. En otros casos, puede ser una IP.

Cómo saber cuál es el host correcto

Revisa la documentación o los correos de bienvenida de tu proveedor.
En cPanel, la sección "Bases de datos MySQL" suele mostrar el host de la base de datos.
Si tienes dudas, contacta con el soporte técnico.

[TIP] Si todo lo demás parece correcto, prueba a cambiar DB_HOST de localhost a 127.0.0.1 o viceversa. A veces el servidor responde de forma diferente a estas dos direcciones.

Paso 5: Repara la base de datos desde phpMyAdmin

A veces la base de datos está dañada, especialmente si hubo una caída del servidor o una importación incorrecta. WordPress incluye una herramienta de reparación que puedes activar de forma manual.

Activar el modo de reparación

Añade esta línea a tu archivo wp-config.php, justo antes de la línea que dice /* That's all, stop editing! */:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y sube los cambios si usas FTP.
Visita esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php.
Verás una pantalla con dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en la primera.
Espera a que termine. Después, elimina la línea que añadiste del wp-config.php para desactivar el modo de reparación.

[WARNING] No dejes el modo de reparación activado. Es una puerta de entrada que puede comprometer la seguridad de tu sitio.

Paso 6: Reinicia el servidor de bases de datos (si tienes acceso)

Si tienes un VPS o un hosting dedicado, es posible que puedas reiniciar el servicio MySQL o MariaDB. Esto soluciona muchos problemas temporales de conexión.

En un servidor con panel (como Syspanel)

Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso se realiza a través del puerto 2106. Dentro de Syspanel, busca la sección de servicios o procesos y reinicia MySQL o MariaDB.

En un VPS con acceso SSH

Si te sientes cómodo con la terminal, ejecuta estos comandos:

sudo systemctl restart mysql

O si usas MariaDB:

sudo systemctl restart mariadb

[INFO] En la mayoría de hostings compartidos no tendrás acceso para reiniciar el servidor. En ese caso, contacta con el soporte técnico y pide que reinicien el servicio MySQL.

Paso 7: Comprueba si el servidor está sobrecargado

Otra causa común del error conexión base de datos WordPress es que el servidor de bases de datos esté sobrecargado. Esto ocurre cuando hay demasiadas conexiones simultáneas o consultas muy pesadas.

Señales de sobrecarga

El error aparece y desaparece de forma intermitente.
La web carga muy lenta antes de mostrar el error.
Otros sitios en el mismo servidor también van lentos.

Si sospechas de esto, contacta con tu proveedor de hosting. Puede ser que necesites aumentar el límite de conexiones o que tu plan sea insuficiente para el tráfico que recibes.

Paso 8: Restaura desde una copia de seguridad

Si has probado todo y nada funciona, la solución más rápida suele ser restaurar tu sitio desde una copia de seguridad reciente. La mayoría de los hostings ofrecen copias automáticas.

En cPanel

Busca la sección "Copias de seguridad" o "Backups".
Restaura la copia más reciente de tu base de datos y, si es necesario, también los archivos.

En Plesk

Ve a "Sitios web y dominios".
Haz clic en "Copias de seguridad" y elige la fecha que quieras restaurar.

En DirectAdmin

Busca "Backups" o "Restaurar".
Selecciona la copia y restaura.

[WARNING] Antes de restaurar, asegúrate de haber intentado los pasos anteriores. Restaurar puede hacer que pierdas cambios recientes en tu sitio.

Paso 9: Revisa los registros de error (logs)

Si eres un poco más técnico, los logs del servidor te darán pistas muy valiosas sobre el origen del problema.

Dónde encontrar los logs

En cPanel: Sección "Registros de errores" o "Error Logs".
En Plesk: "Sitios web y dominios" > "Registros de acceso y errores".
En DirectAdmin: "Logs" o "Registros".

Busca errores que mencionen MySQL, database connection o connect. Esto te ayudará a ti y al soporte técnico a identificar el problema.

Paso 10: Contacta con tu proveedor de hosting

Si después de todos estos pasos sigues viendo el error conexión base de datos WordPress, es hora de pedir ayuda profesional. A veces el problema está fuera de tu alcance, como un fallo en el servidor de bases de datos o un ataque DDoS.

Qué información debes proporcionar al soporte

El mensaje de error exacto.
La URL de tu sitio.
Los pasos que ya has intentado.
Si tienes acceso a los logs, incluye las líneas relevantes.

Preguntas frecuentes (FAQ)

¿Puedo perder mis datos si veo este error?

No. El error solo indica que WordPress no puede conectarse a la base de datos. Tus datos siguen almacenados en el servidor. Una vez solucionado el problema de conexión, todo volverá a la normalidad.

¿Cuánto tiempo tarda en solucionarse?

Depende de la causa. Si es un problema de credenciales, puedes solucionarlo en minutos. Si es un fallo del servidor, puede tardar horas o incluso días, dependiendo de tu proveedor.

¿Debo cambiar mi contraseña de la base de datos?

Solo si sospechas que ha sido comprometida o si el problema se debe a un cambio reciente de contraseña. En ese caso, asegúrate de actualizar también el archivo wp-config.php.

¿Este error puede deberse a un plugin o tema?

Es poco probable. Los plugins y temas no suelen causar este error directamente, aunque un plugin mal optimizado puede sobrecargar la base de datos y provocar problemas de conexión. Si el error aparece después de instalar un plugin, intenta desactivarlo renombrando la carpeta del plugin vía FTP.

¿Qué es Syspanel y por qué solo se accede por el puerto 2106?

Syspanel (anteriormente HestiaCP) es un panel de control de hosting que algunos proveedores utilizan como alternativa a cPanel, Plesk o DirectAdmin. El acceso a su interfaz web se realiza a través del puerto 2106 (por ejemplo, tudominio.com:2106). Si tu hosting usa Syspanel, muchos de los pasos de esta guía serán similares, pero las opciones pueden estar en un lugar diferente.

Consejos finales para evitar este error en el futuro

Realiza copias de seguridad periódicas de tu base de datos y archivos. Así podrás restaurar rápidamente si algo falla.
Mantén WordPress, plugins y temas actualizados. Las actualizaciones corrigen errores que pueden afectar a la conexión con la base de datos.
No cambies la contraseña de la base de datos sin actualizar inmediatamente el archivo wp-config.php.
Supervisa el rendimiento de tu sitio. Si notas que va lento, investiga antes de que se convierta en un error grave.
Elige un hosting de calidad con buen soporte técnico. Un buen proveedor solucionará los problemas de servidor rápidamente.

Espero que esta guía te haya sido de ayuda. Recuerda que el error conexión base de datos WordPress es uno de los más comunes y, en la gran mayoría de los casos, tiene solución. Ve paso a paso, sin prisa, y no dudes en pedir ayuda a tu proveedor de hosting si la necesitas. ¡Tu sitio volverá a estar en línea antes de lo que crees!