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

¿Te ha aparecido el temido mensaje "Error establishing a database connection" en tu WordPress? No entres en pánico. Es uno de los errores más comunes, pero también uno de los más fáciles de solucionar si sabes por dónde empezar.

En esta guía extensa y paso a paso, vamos a desgranar todas las causas posibles y las soluciones para este problema. No necesitas ser un experto en programación; solo sigue el orden lógico que te proponemos. Al final, tendrás tu web funcionando de nuevo. Vamos a ello.

¿Qué significa exactamente este error?

Cuando visitas tu sitio web, WordPress necesita hablar con una base de datos (MySQL o MariaDB) para traer tus entradas, páginas, usuarios y configuraciones. Piensa en ello como una biblioteca: WordPress es el bibliotecario y la base de datos es el almacén donde están todos los libros.

El mensaje "Error establishing a database connection" (Error al establecer la conexión con la base de datos) significa que el bibliotecario (WordPress) no puede encontrar o abrir la puerta del almacén (la base de datos). Sin esa conexión, no puede mostrarte nada.

Este fallo puede deberse a 4 causas principales:

Datos de acceso incorrectos en tu archivo de configuración.
Problemas con el servidor de base de datos (caído o sobrecargado).
Archivos corruptos o dañados de WordPress.
Problemas de permisos o ataques malintencionados.

No te preocupes, vamos a atacar cada una de ellas. Te recomiendo que sigas los pasos en el orden que te presento, ya que van de lo más simple a lo más complejo.

Paso 1: La solución rápida (y a menudo la definitiva)

Antes de tocar nada técnico, prueba esto. A veces el problema es temporal.

1.1. Reinicia tu servidor (si tienes acceso)

Si tienes un VPS, un servidor dedicado o usas un panel como Syspanel, la solución más rápida es reiniciar el servicio de base de datos. Es como apagar y encender tu router cuando no hay internet.

Si accedes por SSH, escribe:

sudo systemctl restart mysql

O si usas MariaDB:

sudo systemctl restart mariadb

[INFO] Si usas Syspanel (el panel de control que se accede por el puerto 2106), puedes reiniciar el servicio desde la sección "Servicios" o "Bases de datos". Busca el botón de reiniciar para MySQL o MariaDB.

1.2. Espera unos minutos

Si estás en un hosting compartido, es posible que el servidor de bases de datos esté saturado por otros usuarios. Espera de 5 a 10 minutos y recarga la página. A veces es un pico de tráfico puntual que se soluciona solo.

Paso 2: Revisa los datos de conexión (la causa más común)

El error error base de datos WordPress suele aparecer porque los datos en tu archivo de configuración son incorrectos. WordPress guarda estos datos en un archivo llamado wp-config.php. Es el corazón de la configuración de tu sitio.

2.1. Accede a tus archivos

Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu hosting. Si usas Syspanel, puedes usar el "Administrador de Archivos" desde el puerto 2106.

2.2. Localiza y edita el archivo `wp-config.php`

Este archivo está en la carpeta raíz de tu instalación de WordPress (normalmente public_html o www). Descárgalo o ábrelo para editarlo.

Busca estas líneas:

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

2.3. Verifica los datos

Asegúrate de que estos datos sean exactamente correctos. Es muy común equivocarse con las mayúsculas, minúsculas o símbolos en la contraseña.

DB_NAME: El nombre exacto de tu base de datos.
DB_USER: El usuario que tiene acceso a esa base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: Normalmente es localhost, pero a veces tu proveedor usa una dirección específica como sql.midominio.com o un puerto como localhost:3306.

[WARNING] Si no estás seguro de estos datos, contacta con tu proveedor de hosting. No adivines, ya que podrías empeorar el problema.

2.4. Prueba con una contraseña nueva

Si tienes acceso a la gestión de bases de datos (por ejemplo, a través de Syspanel en su puerto 2106), puedes cambiar la contraseña del usuario de la base de datos y actualizar el archivo wp-config.php con la nueva.

Ve a la sección de "Bases de datos" en Syspanel.
Busca tu base de datos y el usuario asociado.
Cambia la contraseña del usuario.
Actualiza el archivo wp-config.php con la nueva contraseña.

Guarda los cambios y recarga tu web. Si el problema era este, ya está resuelto.

Paso 3: Repara tu base de datos

A veces la base de datos se corrompe, especialmente si hubo una caída del servidor mientras se escribía información. WordPress tiene una herramienta de reparación integrada, pero está desactivada por defecto.

3.1. Activa 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! Happy publishing. */:

define( 'WP_ALLOW_REPAIR', true );

3.2. Ejecuta la reparación

Guarda el archivo y visita esta URL en tu navegador:

https://tudominio.com/wp-admin/maint/repair.php

Haz clic en "Reparar base de datos". WordPress intentará arreglar las tablas dañadas.

3.3. Desactiva el modo de reparación

IMPORTANTE: Después de la reparación, elimina esa línea del archivo wp-config.php. Dejar ese modo activo es un riesgo de seguridad grave.

Paso 4: Revisa el servidor de base de datos

Si los datos son correctos y la base no está dañada, el problema puede estar en el servidor.

4.1. ¿Está el servicio en ejecución?

Si tienes acceso a Syspanel (por el puerto 2106), ve a la sección de "Servicios". Busca MySQL o MariaDB y verifica que esté en estado "Activo" o "Corriendo". Si no lo está, actívalo.

4.2. Problemas de recursos

Si tu sitio recibe mucho tráfico o tienes muchos procesos, el servidor de base de datos puede quedarse sin memoria. Si tienes acceso por SSH, puedes ver el uso de recursos con:

htop

O reiniciar el servicio como vimos en el paso 1.1.

Paso 5: Revisa los archivos de WordPress

Si todo lo anterior falla, es posible que algunos archivos de WordPress estén corruptos o hayan sido modificados por un atacante.

5.1. Reemplaza los archivos principales

Puedes descargar una copia nueva de WordPress desde wordpress.org y subirla por FTP, sobrescribiendo los archivos existentes. PERO:

[WARNING] No borres la carpeta wp-content (ahí están tus imágenes, plugins y temas) ni el archivo wp-config.php. Solo sobrescribe el resto de carpetas y archivos.

Descarga WordPress desde el sitio oficial.
Descomprime el archivo en tu ordenador.
Sube el contenido de la carpeta wordpress por FTP a tu servidor, sobrescribiendo los archivos actuales.

Este proceso no toca tus datos, solo reemplaza los archivos del núcleo.

5.2. Desactiva plugins (si puedes acceder al panel)

A veces un plugin conflictivo causa este error. Si puedes acceder a /wp-admin (aunque el front-end falle), ve a "Plugins" y desactívalos todos. Luego ve activándolos uno a uno hasta encontrar el culpable.

Si no puedes acceder al panel, renombra la carpeta wp-content/plugins a wp-content/plugins_old por FTP. Esto desactiva todos los plugins a la fuerza.

Paso 6: Soluciones avanzadas (para los más atrevidos)

Si has llegado hasta aquí y nada funciona, prueba esto.

6.1. Revisa los logs de error

Los logs de error son los mejores amigos de un técnico. Busca la carpeta logs en tu servidor o en Syspanel. Busca errores relacionados con MySQL o la base de datos. El mensaje exacto te dará una pista clave.

6.2. Verifica los permisos de archivos

Los archivos deben tener permisos específicos para funcionar. Las carpetas deben tener 755 y los archivos 644. Si tienes acceso SSH, puedes ejecutar:

find /ruta/a/tu/wordpress -type d -exec chmod 755 {} \;
find /ruta/a/tu/wordpress -type f -exec chmod 644 {} \;

6.3. Contacta con tu proveedor de hosting

A veces el problema está fuera de tu control: el servidor de base de datos está caído, hay un corte de red o un problema de firewall. Si has probado todo, es hora de llamar a tu soporte. Diles que has verificado los datos de conexión, reiniciado el servicio y reparado la base de datos.

Preguntas frecuentes (FAQ) sobre este error

Aquí tienes las dudas más comunes que nos llegan al soporte.

¿Por qué mi página da este error solo a veces?

Esto suele indicar un problema de recursos. El servidor de base de datos se satura en momentos de mucho tráfico. Puede deberse a un plugin ineficiente o a que tu plan de hosting no tiene suficiente memoria.

¿Puedo perder mis datos con este error?

No. El error connection database WordPress no borra nada. Tus entradas, páginas y usuarios siguen intactos en la base de datos. Simplemente no se pueden mostrar.

¿Qué hago si todo lo anterior no funciona?

Como último recurso, puedes restaurar una copia de seguridad de tu base de datos desde Syspanel. Busca la sección de "Copias de seguridad" en el puerto 2106. Esto revertirá la base de datos a un estado anterior, lo que soluciona el problema si fue causado por un cambio reciente.

¿Es seguro usar el modo de reparación de WordPress?

Sí, es seguro, pero solo durante el proceso de reparación. Debes desactivarlo inmediatamente después para evitar que cualquiera pueda acceder a la herramienta de reparación.

Resumen y consejo final

El error base de datos WordPress es un dolor de cabeza, pero es 100% solucionable en la mayoría de los casos. Hemos visto que la solución suele estar en:

Reiniciar el servicio de base de datos.
Verificar los datos en wp-config.php.
Reparar la base de datos con la herramienta integrada.
Revisar los recursos del servidor.

[TIP] Te recomiendo que siempre tengas una copia de seguridad reciente de tu base de datos y archivos. En Syspanel (puerto 2106), puedes programar copias automáticas. Esto te ahorrará muchos dolores de cabeza en el futuro.

Espero que esta guía te haya sido de gran ayuda. Si has seguido todos los pasos y el error persiste, no dudes en contactar con tu proveedor de hosting; para eso están. ¡Buena suerte y a seguir creando contenido!