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

¿Qué significa el error de conexión a la base de datos en WordPress?

Si estás viendo el mensaje "Error de conexión a la base de datos" en tu sitio WordPress, no te preocupes. Es uno de los errores más comunes y, por suerte, casi siempre tiene solución. Este aviso aparece cuando WordPress no puede comunicarse con la base de datos donde se almacenan tus entradas, páginas, usuarios y configuraciones.

Imagina que tu web es una tienda y la base de datos es el almacén. Si la puerta del almacén está cerrada o la llave no funciona, la tienda no puede mostrar los productos. Eso es exactamente lo que ocurre aquí.

¿Por qué aparece? Las causas pueden ser varias: desde un cambio accidental en la contraseña, hasta un problema en el servidor o un plugin conflictivo. Pero no te asustes, vamos a revisar paso a paso cómo solucionarlo.

Paso 1: Verifica que el problema no sea temporal

Antes de hacer cambios técnicos, comprueba si es un fallo pasajero. A veces el servidor se sobrecarga o hay una pequeña caída.

Acción: Espera 2-3 minutos y recarga la página. Si el error persiste, continúa con los siguientes pasos.

[TIP] Si tienes acceso a otras webs en el mismo hosting, revisa si funcionan. Si todas fallan, el problema es del servidor y debes contactar a tu proveedor de hosting.

Paso 2: Accede a tu panel de control (Syspanel)

Para solucionar el error, necesitarás acceder a la herramienta que gestiona tu hosting. Si tu proveedor usa Syspanel (anteriormente conocido como HestiaCP), sigue estas indicaciones:

Abre tu navegador y escribe: https://tudominio.com:2106
Ingresa con tu usuario y contraseña de administrador del hosting.
Una vez dentro, busca la sección "Base de datos" o "Databases".

[INFO] El puerto 2106 es exclusivo de Syspanel. Si tu hosting usa otro panel (cPanel, Plesk), el acceso será diferente. Consulta con tu proveedor.

Paso 3: Revisa las credenciales de la base de datos

El error más frecuente es que las credenciales (usuario, contraseña, nombre de la base de datos) no coincidan con las que tiene configuradas WordPress.

¿Dónde están esas credenciales?

En el archivo wp-config.php, que se encuentra en la raíz de tu instalación de WordPress.

Para revisarlo desde Syspanel:

En el panel, ve a "Administrador de archivos" o "File Manager".
Navega hasta la carpeta donde está tu WordPress (normalmente public_html o www).
Busca el archivo wp-config.php y ábrelo con el editor de texto.
Localiza 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');

¿Qué debes comprobar?

DB_NAME: debe coincidir exactamente con el nombre de la base de datos que ves en Syspanel.
DB_USER: igual, debe ser el usuario asignado a esa base.
DB_PASSWORD: la contraseña correcta. Si la cambiaste recientemente, actualízala aquí.
DB_HOST: normalmente es localhost, pero algunos servidores usan direcciones como mysql.tudominio.com. Pregunta a tu hosting si no estás seguro.

[WARNING] Ten cuidado al editar este archivo. No borres ni modifiques otras líneas, solo las que empiezan con define('DB_.

Si encuentras algún error, corrígelo y guarda los cambios. Luego recarga tu web.

Paso 4: Restablece la contraseña de la base de datos

A veces, aunque las credenciales parezcan correctas, la contraseña puede estar dañada o haber sido cambiada sin que lo sepas. Lo mejor es generar una nueva.

Desde Syspanel:

Ve a "Base de datos" > selecciona la base de datos de tu WordPress.
Busca la opción "Cambiar contraseña" o "Reset password".
Genera una nueva contraseña segura (el mismo panel suele ofrecer una).
Copia esa contraseña y pégala en el archivo wp-config.php en la línea DB_PASSWORD.

[TIP] Anota la nueva contraseña en un lugar seguro. Si usas un gestor de contraseñas, mejor.

Paso 5: Verifica el servidor de base de datos

Si las credenciales están bien, el problema puede ser que el servidor de base de datos (MySQL o MariaDB) esté caído o no responda.

Para comprobarlo desde Syspanel:

Ve a "Servicios" o "Services".
Busca MySQL o MariaDB en la lista.
Verifica que esté en estado "Running" o "Activo". Si aparece "Stopped", haz clic en "Iniciar" o "Start".

Si no tienes acceso a Syspanel, contacta a tu proveedor de hosting y pregunta si el servicio MySQL está funcionando.

[INFO] Algunos hostings reinician los servicios automáticamente cada cierto tiempo. Si el error aparece solo por momentos, puede ser un reinicio programado.

Paso 6: Revisa plugins y temas conflictivos

Un plugin o tema mal codificado puede romper la conexión a la base de datos. Para descartarlo:

Desactiva todos los plugins

Desde Syspanel, ve al Administrador de archivos.
Navega a public_html/wp-content/plugins.
Renombra la carpeta plugins a plugins_desactivados (esto desactiva todos los plugins a la vez).
Recarga tu web. Si funciona, el problema era un plugin.
Para identificar cuál, renombra la carpeta a plugins otra vez y ve desactivando uno por uno desde el panel de administración de WordPress (si puedes acceder).

Cambia al tema por defecto

En el Administrador de archivos, ve a public_html/wp-content/themes.
Renombra la carpeta de tu tema activo (ej: mitema a mitema_desactivado).
WordPress automáticamente usará un tema por defecto (Twenty Twenty-Four, por ejemplo).
Si el error desaparece, el tema era el culpable.

[WARNING] Si renombras carpetas, asegúrate de no borrar nada. Siempre puedes revertir el cambio.

Paso 7: Repara la base de datos

A veces la base de datos se corrompe parcialmente. WordPress tiene una herramienta para repararla.

Abre el archivo wp-config.php.
Busca la línea define('WP_DEBUG', false); y justo antes, agrega:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
En tu navegador, visita: https://tudominio.com/wp-admin/maint/repair.php
Haz clic en "Reparar base de datos" (la opción que también optimiza).
Una vez terminado, elimina la línea que agregaste del wp-config.php. Si la dejas, cualquiera podría reparar tu base de datos.

[INFO] Esta herramienta intenta corregir tablas dañadas. No modifica datos, solo estructura.

Paso 8: Contacta a soporte técnico

Si después de todos estos pasos el error persiste, es hora de pedir ayuda profesional. El problema podría ser más profundo: configuración del servidor, firewall bloqueando conexiones, o un ataque malicioso.

Qué decirle a soporte:

"Mi sitio WordPress muestra error de conexión a base de datos."
"Ya revisé credenciales en wp-config.php, reinicié servicios y desactivé plugins."
"Uso Syspanel y el puerto 2106."

[TIP] Guarda capturas de pantalla del error y de los pasos que ya realizaste. Así el soporte resolverá más rápido.

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 respaldo.

¿El error puede ser por un ataque?

Sí, a veces los hackers modifican las credenciales o corrompen la base de datos. Si sospechas, cambia todas las contraseñas (WordPress, base de datos, FTP) y revisa si hay archivos extraños.

¿Qué hago si no encuentro el archivo wp-config.php?

Puede estar oculto. En Syspanel, activa la opción "Mostrar archivos ocultos" en el Administrador de archivos. Si no aparece, quizás tu instalación de WordPress está dañada y necesitas reinstalarla.

¿El error puede ser por falta de espacio en disco?

Sí, si el disco del servidor está lleno, la base de datos no puede escribir. Revisa el espacio disponible en Syspanel o pregunta a tu hosting.

¿Cada cuánto debo respaldar mi base de datos?

Idealmente cada semana o antes de hacer cambios importantes. Usa plugins como UpdraftPlus o la herramienta de respaldo de Syspanel.

Resumen rápido

Verifica si es temporal – espera unos minutos.
Accede a Syspanel (puerto 2106).
Revisa credenciales en wp-config.php.
Restablece contraseña de la base de datos.
Comprueba que MySQL esté activo en Servicios.
Desactiva plugins y tema por si hay conflicto.
Repara la base de datos con la herramienta de WordPress.
Pide ayuda si nada funciona.

Recuerda: este error es común y casi siempre tiene solución. Con paciencia y siguiendo estos pasos, tu web volverá a estar en línea. ¡Ánimo!