Error de conexión a base de datos WordPress: causas y solución

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

Este es uno de los errores más temidos por los usuarios de WordPress, pero no te preocupes. Básicamente, significa que tu sitio web no puede comunicarse con la base de datos donde se almacena todo tu contenido: entradas, páginas, usuarios, comentarios y configuraciones. Sin esa conexión, WordPress no puede funcionar y muestra una pantalla en blanco o un mensaje de error.

Las causas pueden ser varias: desde un simple cambio de contraseña hasta un problema en el servidor. En esta guía te explicamos paso a paso cómo solucionar el error WordPress y recuperar tu sitio.

[INFO] Antes de empezar, si tienes acceso a tu panel de control de hosting (como cPanel, Syspanel o Plesk), te resultará más fácil seguir los pasos. Si no, puedes contactar a tu proveedor de hosting.

1. Verifica tus credenciales de base de datos (wp-config.php)

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene el nombre de la base de datos, el usuario, la contraseña y el servidor. Un error común es que estos datos se hayan modificado accidentalmente.

Pasos para revisar:

Accede a tu hosting mediante FTP (FileZilla, por ejemplo) o al administrador de archivos de tu panel de control.
Busca el archivo wp-config.php en la carpeta raíz de tu instalación de WordPress (normalmente public_html o www).
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Busca las siguientes líneas:

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

Verifica que estos datos sean correctos. Si no estás seguro, puedes consultarlos en tu panel de hosting (por ejemplo, en Syspanel, accede por el puerto 2106 y busca la sección "Bases de datos").
Si cambiaste la contraseña recientemente, actualiza la línea DB_PASSWORD con la nueva.

[WARNING] Ten cuidado al editar este archivo. No borres ni modifiques otras líneas. Si algo sale mal, puedes descargar una copia de seguridad antes de hacer cambios.

2. Comprueba que el servidor de base de datos esté funcionando

A veces el problema no está en tu configuración, sino en el servidor de bases de datos (MySQL o MariaDB). Si el servidor está caído o sobrecargado, WordPress no podrá conectar.

¿Cómo verificarlo?

Si tienes acceso a Syspanel (puerto 2106), revisa el estado de los servicios. Busca "Servicios" o "Estado del servidor" y asegúrate de que MySQL/MariaDB esté "Running" (en ejecución).
Otra opción: usa una herramienta como phpMyAdmin (desde tu panel de hosting) para intentar iniciar sesión. Si no puedes, el problema es del servidor.
También puedes preguntar a tu proveedor de hosting si hay alguna incidencia.

[TIP] Si el servidor de base de datos está caído, no hay mucho que puedas hacer como usuario. Contacta al soporte técnico de tu hosting y reporta el error.

3. Revisa si el usuario de la base de datos tiene los permisos correctos

A veces, el usuario de la base de datos existe y la contraseña es correcta, pero no tiene permisos para acceder a la base de datos específica de WordPress. Esto puede pasar después de migraciones o restauraciones.

Pasos para solucionarlo:

Accede a tu panel de hosting (Syspanel, puerto 2106).
Ve a la sección "Bases de datos" o "MySQL".
Busca la base de datos que usa tu WordPress y el usuario asociado.
Verifica que el usuario esté vinculado a esa base de datos y tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).
Si no es así, asigna los permisos nuevamente. Normalmente hay un botón "Agregar usuario a base de datos" o "Editar privilegios".

[INFO] En Syspanel, esta opción suele estar en "Bases de datos" > "Usuarios". Puedes editar los privilegios y marcar "Todos" para asegurarte.

4. Verifica el nombre del servidor de base de datos (DB_HOST)

La mayoría de las veces el valor de DB_HOST es localhost, pero en algunos hosting compartidos puede ser diferente, como mysql.nombredetudominio.com o una IP.

Cómo obtener el host correcto:

Revisa la documentación de tu hosting o el panel de control.
En Syspanel (puerto 2106), busca la sección "Bases de datos" y verás el "Servidor" o "Host".
Si usas un servicio como SiteGround, DreamHost, etc., suelen proporcionar un host específico.

[WARNING] No asumas que siempre es localhost. Si cambiaste de hosting o migraste tu sitio, es posible que el host haya cambiado. Un error común es tener el host incorrecto.

5. Repara la base de datos de WordPress

WordPress tiene una función integrada para reparar bases de datos corruptas. Para activarla, debes agregar una línea en wp-config.php:

Abre wp-config.php como hiciste antes.
Agrega esta línea justo antes del comentario final (antes de /* That's all, stop editing! */):

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ve a esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con opciones. Haz clic en "Reparar base de datos" (o "Repair Database").
Una vez terminado, elimina esa línea de wp-config.php para evitar riesgos de seguridad.

[TIP] Esta herramienta repara tablas dañadas, pero no soluciona problemas de conexión. Úsala solo si sospechas que la base de datos está corrupta.

6. Verifica que el archivo wp-config.php no esté dañado

A veces, al editar el archivo, podemos introducir un error de sintaxis (una comilla mal puesta, un espacio extra, etc.) que impide que WordPress lo lea correctamente.

Cómo verificarlo:

Descarga una copia limpia de WordPress desde wordpress.org.
Extrae el archivo wp-config-sample.php.
Compara su estructura con tu wp-config.php (sin copiar los datos de la base de datos, solo la estructura).
Asegúrate de que las líneas de configuración estén completas y sin caracteres extraños.

[WARNING] Si no estás seguro, pide ayuda a un técnico. Un wp-config.php mal editado puede dejar tu sitio inaccesible.

7. Comprueba problemas de permisos de archivos

Los permisos incorrectos en los archivos de WordPress pueden impedir que el sistema lea la configuración. Aunque es menos común, vale la pena revisarlo.

Pasos:

Conéctate por FTP.
Los archivos deben tener permisos 644 (lectura y escritura para el propietario, solo lectura para otros).
Las carpetas deben tener permisos 755.
Si ves valores como 777 o 000, cámbialos a los correctos.

[INFO] En Syspanel, también puedes cambiar permisos desde el administrador de archivos, haciendo clic derecho sobre el archivo o carpeta.

8. Revisa si hay un plugin o tema conflictivo

En raras ocasiones, un plugin o tema mal configurado puede alterar la conexión a la base de datos. Para descartarlo:

Desactiva todos los plugins. Puedes hacerlo renombrando la carpeta wp-content/plugins a wp-content/plugins_old mediante FTP.
Si el error desaparece, reactiva los plugins uno por uno para encontrar el culpable.
También puedes cambiar temporalmente al tema por defecto (Twenty Twenty-Four o similar) renombrando la carpeta de tu tema activo en wp-content/themes.

[TIP] Si no puedes acceder al panel de administración, esta es la única forma de probar.

9. Pide ayuda a tu proveedor de hosting

Si después de todos estos pasos el error conexión base datos WordPress persiste, es hora de contactar al soporte técnico. Ellos pueden:

Verificar el estado del servidor MySQL.
Revisar los logs de errores del servidor.
Reiniciar servicios si es necesario.
Migrar tu base de datos a un servidor más estable.

[WARNING] No intentes hacer cambios drásticos como eliminar la base de datos o reinstalar WordPress sin hacer una copia de seguridad. Podrías perder todo tu contenido.

Preguntas frecuentes (FAQ)

¿Por qué aparece "Error establishing a database connection" de repente?

Puede deberse a un cambio de contraseña de la base de datos, un plugin conflictivo, un ataque de fuerza bruta que satura el servidor, o un problema temporal del hosting.

¿Puedo solucionarlo sin acceso al panel de administración?

Sí. Todos los pasos de esta guía se pueden realizar mediante FTP, phpMyAdmin o el panel de control de tu hosting.

¿Qué hago si mi hosting usa Syspanel?

Accede a Syspanel a través del puerto 2106 (ejemplo: tudominio.com:2106). Allí podrás gestionar bases de datos, usuarios y permisos. Busca la sección "Bases de datos" para verificar credenciales y privilegios.

¿El error puede deberse a un límite de conexiones?

Sí, si tu sitio recibe mucho tráfico o hay muchos procesos, el servidor puede alcanzar el límite de conexiones simultáneas. Contacta a tu hosting para aumentarlo.

¿Debo reinstalar WordPress?

No es recomendable. La reinstalación no soluciona problemas de conexión a la base de datos, y además perderías tus ajustes. Mejor sigue los pasos de esta guía.

Resumen final

El database connection error WordPress es frustrante, pero en la mayoría de los casos se soluciona revisando el archivo wp-config.php, verificando credenciales y permisos, o pidiendo ayuda al hosting. Sigue estos pasos en orden y, si todo falla, no dudes en contactar a un profesional.

Recuerda: siempre haz una copia de seguridad antes de hacer cambios importantes. ¡Buena suerte y esperamos que tu sitio vuelva a funcionar pronto!