Error de conexión a base de datos en WordPress: cómo solucionarlo

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has encontrado con el temido mensaje "Error de conexión a la base de datos" en tu WordPress. No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. Vamos a desglosarlo paso a paso, como si lo hiciéramos juntos frente a la pantalla.

¿Qué significa este error?

Cuando tu sitio WordPress muestra “Error de conexión a la base de datos”, significa que WordPress no puede comunicarse con la base de datos donde se almacena todo tu contenido: entradas, páginas, usuarios, comentarios, etc. Sin esa conexión, el sitio no puede cargar nada. Las causas pueden ir desde un simple cambio de contraseña hasta un servidor sobrecargado.

[INFO] Este error es diferente al "Error al establecer conexión con la base de datos" que a veces aparece al instalar WordPress. Ambos son similares, pero las soluciones pueden variar ligeramente.

Causas más frecuentes del error conexión WordPress

Antes de lanzarnos a soluciones técnicas, identifiquemos por qué ocurre. Las razones principales son:

Credenciales incorrectas en el archivo wp-config.php.
Base de datos caída o corrupta (por ejemplo, por un plugin conflictivo).
Servidor de base de datos sobrecargado (demasiadas conexiones simultáneas).
Problemas con el hosting (mantenimiento, límites de recursos, firewall).
Archivos de WordPress dañados (por una actualización interrumpida).

Paso 1: Verifica el estado de tu base de datos (lo más común)

Lo primero es saber si la base de datos está realmente funcionando. Puedes hacerlo desde el panel de control de tu hosting.

Si usas cPanel:

Accede a cPanel (normalmente en tudominio.com/cpanel).
Busca la sección "Bases de datos" y haz clic en "phpMyAdmin".
En la columna izquierda, verás una lista de bases de datos. Haz clic en la que usa tu WordPress.
Si ves tablas (como wp_posts, wp_options), la base de datos existe y está accesible. Si ves un mensaje de error, está caída.

Si usas Syspanel (HestiaCP) – Puerto 2106:

Abre tu navegador y escribe https://tudominio.com:2106 (sí, con el puerto 2106).
Inicia sesión con tus credenciales de Syspanel.
Ve a "Bases de datos" en el menú lateral.
Busca tu base de datos y haz clic en "phpMyAdmin" (o en "Administrar" si no aparece).
Si puedes ver las tablas, la base de datos está bien. Si no, puede estar caída.

[WARNING] Si no puedes acceder a phpMyAdmin desde tu panel, contacta a tu proveedor de hosting. Podría ser un bloqueo temporal.

Paso 2: Revisa el archivo `wp-config.php`

Este archivo contiene las credenciales de conexión a la base de datos. Un error aquí provoca el fallo.

Conéctate a tu servidor vía FTP o desde el administrador de archivos de tu panel.
Localiza el archivo wp-config.php en la raíz de tu instalación de WordPress.
Ábrelo con un editor de texto (Bloc de notas, Sublime Text, etc.).
Busca estas 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 los datos sean correctos. El nombre, usuario y contraseña deben coincidir exactamente con los que creaste en tu base de datos.
El DB_HOST normalmente es localhost, pero algunos hostings usan algo como mysql.tudominio.com o 127.0.0.1. Si no estás seguro, consulta la documentación de tu hosting.

[TIP] Si cambiaste la contraseña de la base de datos recientemente, asegúrate de actualizarla también en este archivo.

Paso 3: Repara la base de datos desde WordPress

WordPress tiene una herramienta oculta para reparar la base de datos. Actívala temporalmente:

Abre wp-config.php y agrega esta línea justo antes del comentario final (antes de /* ¡Eso es todo, deja de editar! */):

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
En tu navegador, visita: https://tudominio.com/wp-admin/maint/repair.php
Verás dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Recomiendo primero solo reparar.
WordPress revisará las tablas y corregirá errores comunes.
IMPORTANTE: Una vez terminado, elimina esa línea de wp-config.php o cámbiala a false. Dejarla activa es un riesgo de seguridad.

[INFO] Esta herramienta no siempre soluciona problemas graves, pero es un primer paso rápido.

Paso 4: Verifica si la base de datos está caída por sobrecarga

A veces el servidor de base de datos (MySQL/MariaDB) se cae por exceso de conexiones o por un pico de tráfico. Esto es más común en hostings compartidos.

¿Cómo saberlo?

Si otros sitios en el mismo hosting también fallan, probablemente es un problema del servidor.
Puedes preguntar a tu proveedor de hosting si el servicio de base de datos está caído.

Solución temporal: Espera unos minutos y recarga la página. Si el error persiste, contacta al soporte.

Paso 5: Comprueba si hay plugins o temas conflictivos

Un plugin o tema mal codificado puede corromper la base de datos o bloquear la conexión.

Desactiva todo desde FTP:

Conéctate por FTP a tu servidor.
Ve a la carpeta /wp-content/plugins/.
Cambia el nombre de la carpeta plugins a plugins_old (esto desactiva todos los plugins).
Recarga tu sitio. Si funciona, el problema era un plugin.
Para identificar cuál, renombra la carpeta a plugins de nuevo, y luego ve renombrando cada plugin individualmente (por ejemplo, akismet a akismet_des) hasta que el error desaparezca.

Si el tema es el problema:

Cambia el nombre de la carpeta del tema activo en /wp-content/themes/ (por ejemplo, de twentytwentythree a twentytwentythree_old). WordPress usará un tema por defecto.

Paso 6: Revisa los logs del servidor (para usuarios avanzados)

Si nada funciona, los logs pueden darte pistas. Si tienes acceso SSH o a los logs de error:

En cPanel: busca "Errores" o "Registros de errores".
En Syspanel (puerto 2106): ve a "Registros" > "Registro de errores".
Busca líneas con [error] que mencionen mysql_connect() o base de datos.

[WARNING] Manipular logs sin experiencia puede ser confuso. Si no te sientes seguro, salta al siguiente paso.

Paso 7: Contacta a tu soporte técnico

Si después de todos estos pasos el error persiste, es hora de llamar a los expertos. Proporciona la siguiente información:

Captura de pantalla del error exacto (incluye la URL).
Pasos que ya intentaste (para que no repitan).
Últimos cambios (instalaste un plugin, cambiaste contraseña, etc.).

La mayoría de los hostings tienen soporte 24/7. Si usas Syspanel, recuerda que el acceso al panel es por el puerto 2106, y ellos pueden verificar el estado del servidor MySQL.

Preguntas frecuentes (FAQ)

¿Puedo perder datos si reparo la base de datos?

No, la reparación solo corrige índices y tablas dañadas. No borra contenido. Pero siempre es recomendable tener un backup.

¿El error "WordPress no conecta" puede deberse a mi navegador?

Muy raramente. Prueba en modo incógnito o con otro navegador, pero lo más probable es que sea del servidor.

¿Qué hago si veo "Base de datos caída" en mi panel?

Significa que el servicio MySQL no está corriendo. Si tienes acceso SSH, puedes reiniciarlo con sudo service mysql restart (en Linux). Si no, contacta al soporte.

¿Cada cuánto debo hacer backups?

Idealmente, cada vez que actualices WordPress, plugins o temas. Muchos hostings ofrecen backups automáticos. Actívalos.

Resumen final

El error de conexión a la base de datos en WordPress es frustrante, pero rara vez es un problema sin solución. Siguiendo estos pasos:

Verifica la base de datos desde el panel.
Revisa wp-config.php.
Repara desde WordPress.
Desactiva plugins/temas.
Consulta logs o llama al soporte.

Recuerda que la paciencia es clave. Si no te sientes cómodo con algún paso, no dudes en pedir ayuda. ¡Tu sitio volverá a estar en línea pronto!

[TIP] Para evitar futuros sustos, programa backups semanales y mantén WordPress, plugins y temas actualizados. Un buen hosting también hace la diferencia.

Espero que este artículo te haya sido de gran ayuda. Si tienes más dudas, aquí estoy para ayudarte. ¡Buena suerte con tu WordPress!