Error de conexión a base de datos en WordPress | Solución

¡Hola! 👋 Si estás leyendo esto, es muy probable que hayas intentado abrir tu sitio web hoy y te hayas encontrado con un mensaje bastante frustrante: "Error al establecer una conexión con la base de datos". No te preocupes, respira hondo. Es uno de los problemas más comunes en WordPress, pero también de los que más fácil se solucionan si sigues los pasos adecuados.

En esta guía completa, vamos a desglosar qué significa este error base datos wordpress, por qué ocurre y, lo más importante, cómo solucionarlo paso a paso. No necesitas ser un experto en informática; solo sigue las instrucciones y, en la mayoría de los casos, tendrás tu web funcionando en minutos.

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

Antes de lanzarnos a arreglar nada, vamos a entender qué está pasando. Piensa en tu sitio web como una tienda física.

WordPress es el edificio y los muebles (la parte visual y el código).
La Base de Datos (BD o DB) es el almacén donde guardas todos los productos (tus artículos, páginas, comentarios, usuarios y ajustes).

El mensaje de error significa que WordPress (el edificio) está abierto, pero no puede encontrar o acceder al almacén (la base de datos). Sin ese almacén, no puede mostrar nada de lo que hay dentro, por eso ves la página en blanco o con ese mensaje tan feo.

Este problema puede deberse a varias razones, desde un simple corte de luz en el servidor hasta un error al escribir una contraseña. Vamos a ver las causas más frecuentes y, sobre todo, cómo solucionarlas.

Primeros Pasos: El Diagnóstico Rápido

Cuando te enfrentas a un wordpress no conecta db, lo primero es no entrar en pánico. Hay dos formas de intentar arreglarlo: una "fácil" y una "técnica". Empecemos por la fácil porque, a veces, la solución es más simple de lo que creemos.

1. El Clásico: Reiniciar el Servidor

Sí, suena a tópico, pero funciona. En el 90% de los casos, este error es temporal y está causado por un fallo puntual del servidor de bases de datos (MySQL o MariaDB). Es como cuando se te cuelga el móvil y lo reinicias.

¿Cómo se hace? Depende de dónde esté alojada tu web.

Si usas un hosting compartido (cPanel, Syspanel, etc.): Normalmente no puedes reiniciar el servidor de BD directamente, pero sí puedes intentar apagar y encender tu servicio de hosting desde el panel de control. Busca un botón que ponga "Reiniciar" o "Restart" en la sección de "Administración de Servicios".
Si usas un VPS o un servidor dedicado: Tienes más control. Deberías poder reiniciar el servicio de base de datos. Por ejemplo, si tienes acceso por terminal (SSH), podrías escribir (esto es para usuarios más avanzados):
- sudo systemctl restart mysql (en la mayoría de sistemas basados en Debian/Ubuntu).
- sudo systemctl restart mariadb (si usas MariaDB).

[TIP] Antes de hacer nada más, espera un par de minutos y recarga tu página. Muchas veces, el simple hecho de que el servidor se reinicie solo (o que el soporte del hosting lo haga por ti) resuelve el problema al instante.

2. El Error Clásico de "wp-config.php"

Si reiniciar no funcionó, el siguiente sospechoso habitual es el archivo de configuración principal de WordPress. Este archivo contiene las "llaves" para abrir el almacén: el nombre de la base de datos, el usuario y la contraseña.

A veces, sin querer, se corrompe o se guardan datos incorrectos. La solución es verificar y, si es necesario, corregir estos datos.

¿Cómo acceder al archivo? Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de hosting.

Conéctate a tu servidor y navega hasta la carpeta raíz de tu WordPress (normalmente public_html o www).
Busca un archivo llamado wp-config.php.
Ábrelo con un editor de texto (el Bloc de notas de Windows o TextEdit en Mac te valen).

Verás una sección que dice así (más o menos):

define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'tu_usuario_de_bd' );
define( 'DB_PASSWORD', 'tu_contraseña_secreta' );
define( 'DB_HOST', 'localhost' );

Aquí tienes que verificar que estos datos son correctos. ¿De dónde saco estos datos? De tu panel de control del hosting. Busca la sección de "Bases de Datos MySQL". Ahí verás el nombre de la BD, el usuario y podrás cambiar la contraseña.

[WARNING] ¡Cuidado! No cambies nada más en este archivo si no sabes lo que haces. Un error al editar wp-config.php puede romper tu sitio por completo. Solo céntrate en las líneas DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.

¿Y si los datos son correctos? Entonces, el problema no es este. Puedes intentar cambiar la contraseña de la base de datos desde tu panel de hosting y, acto seguido, actualizar la contraseña en el archivo wp-config.php. A veces, se produce un desajuste entre lo que el servidor espera y lo que hay en el archivo.

3. El Problema del Hosting: "DB_HOST" o "localhost"

Este es un error muy típico. En la mayoría de los hostings compartidos, el host de la base de datos es localhost. Sin embargo, en otros (especialmente en hostings más grandes o gestionados), el servidor de bases de datos está en una dirección distinta, como mysql.tudominio.com o db12345.hostingcompany.com.

Si has verificado que el nombre de usuario y contraseña son correctos, pero sigues sin poder conectar, revisa la línea DB_HOST.

Lo primero: Intenta cambiar DB_HOST a localhost si no lo está.
Lo segundo: Si localhost no funciona, mira en la documentación o en el correo de bienvenida de tu hosting. A veces te indican el nombre del servidor de base de datos. Esa dirección debe ir en la línea DB_HOST.

[INFO] En algunos paneles de control como Syspanel (que puedes acceder por el puerto 2106), la información de la base de datos aparece claramente indicada en el panel de "Bases de Datos". Revisa ahí antes de adivinar.

Soluciones Avanzadas: Cuando el Problema es Más Profundo

Si has llegado hasta aquí y aún tienes el wp db error, significa que el problema no es de configuración, sino de los cimientos de tu servidor. Vamos a por las soluciones más técnicas.

4. El Hosting se Quedó Sin Espacio o Recursos

Imagina que tu almacén está lleno hasta arriba. WordPress no puede escribir ni leer nuevos datos porque no hay sitio. Esto provoca errores de conexión.

¿Cómo comprobarlo?

Revisa el espacio en disco de tu hosting. Si está al 100%, libera espacio (borra archivos temporales, copias de seguridad antiguas, etc.).
También puede ser que tu servidor esté sobrecargado de procesos. Si tu web tiene mucho tráfico o algún plugin está haciendo un mal uso de los recursos, el servidor de BD puede "colapsarse" y negar conexiones.

¿Qué hago? Si el problema es de espacio, límpialo. Si es de recursos, puede que necesites contratar un plan superior o, al menos, desactivar temporalmente algún plugin pesado (puedes hacerlo renombrando la carpeta wp-content/plugins a wp-content/plugins_bak desde FTP). Esto desactivará todos los plugins y, si el error desaparece, ya sabes quién es el culpable.

5. El Archivo `.htaccess` (Menos Común, Pero Importante)

Aunque no está directamente relacionado con la base de datos, un archivo .htaccess corrupto puede causar errores extraños.

Solución: Conéctate por FTP a tu servidor y busca el archivo .htaccess en la raíz. Renómbralo a algo como .htaccess_old (no lo borres). Luego, ve a tu panel de WordPress (si puedes) y en Ajustes > Enlaces Permanentes, pulsa "Guardar cambios" para regenerarlo.

[WARNING] Si renombras .htaccess y tu web no usa enlaces permanentes "bonitos", puede que no funcione. Pero es una prueba rápida. Si el problema persiste, vuelve a ponerle el nombre original.

6. El Plugin de Cache o de Seguridad

A veces, un plugin de caché (como W3 Total Cache) guarda información de la conexión a la base de datos en archivos temporales. Si esos archivos se corrompen, pueden causar el error.

Solución: Desactiva todos los plugins. Sí, todos. La forma más segura de hacerlo es por FTP:

Conéctate a tu servidor.
Ve a la carpeta wp-content.
Renombra la carpeta plugins a plugins_desactivados.
Recarga tu web. Si el error desaparece, entonces el problema es un plugin.
Ahora, renombra la carpeta de nuevo a plugins (para volver a activarlos todos). Ve a tu panel de WordPress y ve activando los plugins uno a uno (o en grupos) hasta que encuentres el que causa el conflicto.

7. Reparar las Tablas de la Base de Datos

Las bases de datos pueden "romperse" internamente. Es como si el índice de un libro se estropeara y no pudieras encontrar las páginas. WordPress tiene una herramienta para repararlas.

Cómo hacerlo:

Abre tu archivo wp-config.php con un editor de texto.
Busca la línea que dice define('WP_DEBUG', false); (o similar).
Justo después de esa línea, añade esta otra:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Ahora, ve a esta URL en tu navegador: https://tudominio.com/wp-admin/maint/repair.php

Verás una pantalla que te ofrece "Reparar la base de datos" o "Reparar y Optimizar". Haz clic en uno de ellos.

[WARNING] ¡IMPORTANTE! Una vez que hayas terminado de reparar, BORRA esa línea de código (define('WP_ALLOW_REPAIR', true);) de tu wp-config.php. Si la dejas, cualquiera podría acceder a esa URL y dañar tu base de datos. Es una puerta trasera peligrosa.

8. Consulta con tu Proveedor de Hosting

Si has probado absolutamente todo y el wordpress no conecta db persiste, el problema es 100% del servidor. Puede ser un fallo de hardware, un problema con el firewall o una configuración interna del servicio de bases de datos.

¿Qué hacer? Contacta con el soporte técnico de tu hosting. Explícales que tienes un error de conexión a la base de datos y que ya has verificado la configuración de wp-config.php y el espacio en disco. Ellos tienen acceso a logs internos que tú no puedes ver y podrán diagnosticar el problema real.

Preguntas Frecuentes (FAQ)

¿Por qué me sale el error solo a veces?

Es típico de servidores sobrecargados. Si hay picos de tráfico, el servidor de BD puede estar saturado y rechazar conexiones puntualmente. Si es muy frecuente, considera mejorar tu plan de hosting.

¿Puedo perder mis datos por este error?

Rara vez. La base de datos está intacta; simplemente no se puede acceder a ella. Una vez que se restablece la conexión, todos tus datos siguen ahí. Eso sí, es una buena práctica tener copias de seguridad periódicas (tu hosting puede ofrecerlas o puedes usar plugins como UpdraftPlus).

¿Qué es "DB_HOST"? ¿Por qué no es "localhost"?

Es la dirección del servidor donde se encuentra la base de datos. En muchos hostings baratos o compartidos, la BD y el servidor web están en la misma máquina, por eso se usa localhost. En hostings más potentes o en la nube, la BD puede estar en un servidor independiente, por lo que la dirección es diferente.

Estoy usando Syspanel, ¿qué hago?

Si tu hosting usa Syspanel, el panel de control al que accedes por el puerto 2106, la gestión es similar a cPanel. Busca la sección de "Bases de Datos". Ahí podrás ver el nombre de la BD, el usuario y, lo más importante, el host de la base de datos. A veces, en Syspanel, el host no es localhost sino algo como 127.0.0.1 o una dirección interna. Copia exactamente lo que te ponga en el campo "Host" o "Servidor" y pégala en tu wp-config.php.

[TIP] Si tu hosting usa Syspanel, es muy probable que el soporte técnico te pida que les envíes una captura de pantalla de la sección de Bases de Datos y de tu archivo wp-config.php (con las contraseñas ocultas) para ayudarte más rápido.

Resumen Final: Tu Plan de Acción

Para que no te pierdas, aquí tienes la lista de verificación definitiva para solucionar el error base datos wordpress:

Reinicia tu servicio de hosting (o pide al soporte que lo hagan).
Verifica tu archivo wp-config.php (nombre, usuario y contraseña de la BD).
Comprueba el DB_HOST (cambia entre localhost y la dirección que te dé tu hosting).
Revisa el espacio en disco de tu servidor.
Desactiva todos los plugins (renombrando la carpeta plugins).
Repara la base de datos con la herramienta repair.php.
Contacta con tu soporte técnico.

Espero que esta guía te haya sido de gran ayuda. La próxima vez que veas ese temido mensaje, ya sabrás que tienes un plan de acción claro. ¡No te rindas, que tu web volverá a la vida! Si te ha servido, compártelo con quien lo necesite. ¡Buena suerte!