Error de conexión a base de datos en WordPress: Solución fácil

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver una de las situaciones más desconcertantes que puedes encontrar al gestionar tu página web: el temido error de conexión a la base de datos de WordPress.

No te preocupes, es un problema muy común y, por lo general, tiene solución. Piensa en la base de datos como el archivo maestro de tu web. Si WordPress no puede hablar con él, tu página se queda en blanco o muestra un mensaje de error. Vamos a convertir ese «error conexión base datos WordPress» en algo del pasado.

Este artículo está diseñado como una FAQ (Preguntas Frecuentes) para que puedas ir directo al grano y solucionar error base datos WordPress paso a paso.

¿Qué significa exactamente el error «Error al establecer una conexión a la base de datos»?

Cuando ves este mensaje, significa que WordPress ha intentado conectarse a tu base de datos MySQL (o MariaDB) y no ha podido. Las causas pueden ser varias, desde un dato mal escrito hasta un servidor sobrecargado.

¿Cómo se ve? Tu web mostrará un texto similar a:
«Error establishing a database connection» o «Error al establecer una conexión a la base de datos».

[INFO] No entres en pánico. Este error rara vez significa que has perdido tus datos. Solo significa que WordPress no encuentra la «llave» correcta para abrir la puerta de la base de datos.

¿Cuáles son las causas más comunes del «WordPress error base de datos»?

Antes de lanzarnos a las soluciones, identifiquemos al culpable. Las causas más frecuentes son:

Credenciales incorrectas en wp-config.php: El archivo de configuración de WordPress tiene un nombre de usuario, contraseña, nombre de base de datos y servidor. Si uno de estos está mal, la conexión falla.
Servidor de base de datos caído o sobrecargado: El servidor donde se aloja tu base de datos (a veces el mismo que tu hosting) puede estar temporalmente fuera de servicio.
Corrupción de la base de datos: Aunque es menos común, una tabla de la base de datos puede dañarse.
Problemas de permisos: El usuario de la base de datos puede no tener los permisos necesarios para acceder a ella.
Plugin o tema conflictivo: Un plugin mal codificado puede, en raras ocasiones, bloquear la conexión.
Cambios recientes en el hosting: Si has migrado tu web o cambiado de plan, las credenciales pueden haber cambiado.

FAQ: Guía paso a paso para solucionar el error

Aquí tienes las preguntas más frecuentes y cómo resolverlas. Recomiendo seguir este orden, de lo más simple a lo más complejo.

1. ¿Cómo verifico las credenciales en el archivo wp-config.php?

Este es el primer lugar donde debes mirar. El archivo wp-config.php está en la raíz de tu instalación de WordPress.

Paso a paso:

Accede a tu hosting. Usa un administrador de archivos (como el de cPanel o Syspanel) o un cliente FTP (como FileZilla).
Navega a la carpeta raíz de tu WordPress (normalmente public_html o www).
Busca el archivo wp-config.php y ábrelo con un editor de texto (como el Bloc de notas o el editor integrado).

Busca estas líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_de_la_base');
define('DB_HOST', 'localhost');

Comprueba que estos datos sean EXACTAMENTE IGUALES a los que te proporcionó tu proveedor de hosting. Un error común es cambiar la contraseña en el panel de control pero no actualizar este archivo.
Asegúrate de que DB_HOST sea correcto. A menudo es localhost, pero algunos hostings usan una dirección IP o un nombre de servidor específico (ej: mysql.tudominio.com).

[WARNING] Ten mucho cuidado al editar wp-config.php. No borres ni añadas nada más. Si no estás seguro, haz una copia de seguridad del archivo original.

2. ¿Cómo reparo una base de datos corrupta?

A veces, la base de datos se «rompe» ligeramente. WordPress tiene una herramienta oculta para repararla.

Paso a paso:

Abre tu archivo wp-config.php (como en el paso anterior).
Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, añade esta línea:
define('WP_ALLOW_REPAIR', true);
Guarda el archivo y súbelo de nuevo si es necesario.
Visita esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
(Reemplaza tudominio.com con tu dominio real).
Verás una pantalla con dos opciones: «Repair Database» (Reparar) y «Repair and Optimize Database» (Reparar y Optimizar). Recomiendo elegir la primera.
Espera a que termine. Te mostrará un mensaje de éxito o te dirá qué tablas se repararon.
¡IMPORTANTE! Una vez terminado, vuelve a tu wp-config.php y ELIMINA la línea que añadiste. Dejarla activa es un riesgo de seguridad.

[INFO] Esta herramienta no siempre funciona si el error es de conexión, pero es un paso rápido y sencillo que vale la pena intentar.

3. ¿Mi servidor de base de datos está caído? ¿Cómo lo compruebo?

A veces el problema no es tuyo, sino del servidor. Si tu hosting usa cPanel, Syspanel o Plesk, puedes verificarlo.

Paso a paso:

Accede a tu panel de control. Por ejemplo, si usas Syspanel, accede a través de tudominio.com:2106 con tus credenciales de administrador.
Busca una sección llamada «Servicios», «Estado del Servidor» o similar.
Verás una lista de servicios (Apache, MySQL, FTP, etc.). Busca MySQL o MariaDB.
Comprueba que el estado sea «Running» (Ejecutándose) o un círculo verde. Si está rojo o dice «Stopped» (Detenido), el problema está en el servidor.
- Si está detenido: En muchos paneles puedes hacer clic en un botón «Start» o «Reiniciar» para reactivarlo.
- Si no puedes reiniciarlo: Contacta con el soporte de tu hosting. Diles que el servicio MySQL está caído.

4. ¿Cómo reinicio el servicio MySQL desde mi panel de control?

Si tienes acceso a un panel como Syspanel (puerto 2106) o cPanel, puedes reiniciar el servicio fácilmente.

Ejemplo con Syspanel:

Inicia sesión en Syspanel (tudominio.com:2106).
Ve a «Servicios» o «Service Manager».
Busca MySQL en la lista.
Haz clic en el botón «Restart» (Reiniciar). Espera unos segundos.
Vuelve a cargar tu web. A menudo, un simple reinicio soluciona errores temporales.

[TIP] Si no ves la opción de reiniciar, tu plan de hosting puede no tener permisos de administrador del servidor. En ese caso, contacta al soporte.

5. ¿Puede un plugin o tema causar este error? ¿Cómo lo soluciono?

Sí, aunque es menos común, un plugin defectuoso puede corromper la conexión o saturar la base de datos.

Paso a paso para desactivar plugins sin acceso al panel:

Accede a tu hosting por FTP o administrador de archivos.
Navega a la carpeta wp-content.
Dentro de wp-content, busca la carpeta plugins.
Cambia el nombre de la carpeta plugins a plugins_old (o cualquier otro nombre). Esto desactivará TODOS los plugins de golpe.
Intenta cargar tu web. Si funciona, el problema era un plugin.
Para identificar cuál: Crea una nueva carpeta llamada plugins (vacía) y luego ve moviendo los plugins de plugins_old a plugins de uno en uno, recargando la web cada vez. Cuando el error vuelva a aparecer, habrás encontrado al culpable.

Para desactivar un tema:

Accede a la carpeta wp-content/themes.
Cambia el nombre de la carpeta de tu tema activo (ej: tema-activo a tema-activo_desactivado). WordPress usará automáticamente un tema por defecto (Twenty Twenty-Four, etc.).
Si el error desaparece, el tema es el problema.

6. ¿Qué hago si nada de esto funciona? (Solución avanzada)

Si has probado todo lo anterior y el error persiste, es hora de pedir ayuda profesional o revisar la configuración del servidor a un nivel más profundo.

Últimos pasos:

Contacta a tu proveedor de hosting. Explícales que has verificado las credenciales, reiniciado MySQL y desactivado plugins. Ellos pueden revisar los logs del servidor y ver si hay un error más profundo (como un límite de conexiones alcanzado o un problema de firewall).
Revisa los logs de errores de WordPress. En tu servidor, busca un archivo llamado debug.log dentro de wp-content. Si no existe, puedes habilitar el modo debug en wp-config.php añadiendo:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
Luego, visita tu web para generar el error y revisa el archivo debug.log. Contendrá mensajes más técnicos que tu hosting puede interpretar.
Verifica los permisos de la base de datos. Si tienes acceso a phpMyAdmin (desde tu panel de control), puedes comprobar que el usuario de la base de datos tenga todos los privilegios sobre la base de datos. Si no sabes hacerlo, pide ayuda al soporte.

[WARNING] No modifiques nada en phpMyAdmin si no estás seguro de lo que haces. Podrías borrar datos accidentalmente.

Conclusión: No pierdas la calma

El error conexión base datos WordPress es como un corte de luz en tu casa: molesto, pero generalmente reparable. Siguiendo esta FAQ WordPress base datos, podrás resolver el 90% de los casos por ti mismo.

Recuerda el orden lógico:

Revisa wp-config.php (credenciales).
Reinicia el servicio MySQL desde tu panel (Syspanel, cPanel, etc.).
Repara la base de datos con la herramienta oculta.
Desactiva plugins y temas por FTP.
Pide ayuda a tu hosting si nada funciona.

Espero que este artículo te haya sido de gran ayuda. ¡Tu web volverá a estar online en poco tiempo! Si tienes más dudas, no dudes en consultar a tu equipo de soporte.