Error de conexión a base de datos en WordPress: Causas y solución

¡Hola! Soy el técnico de soporte amigable. Si estás leyendo esto es porque seguramente te has topado con el temido mensaje “Error de conexión a 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. Vamos a desglosarlo paso a paso para que puedas recuperar tu web en pocos minutos.

¿Qué significa exactamente este error?

Cuando WordPress intenta cargar tu sitio, necesita conectar con la base de datos, que es donde se almacenan tus artículos, usuarios, comentarios y configuraciones. Si la conexión falla, el sistema no puede obtener la información necesaria y muestra ese molesto mensaje. Las causas pueden ser varias: desde un cambio accidental en la contraseña hasta un problema en el servidor.

Causas más frecuentes del error

Aquí tienes las razones principales por las que aparece este problema. Revisa esta lista antes de ponerte manos a la obra:

Credenciales incorrectas en el archivo de configuración de WordPress (wp-config.php).
El servidor de base de datos está caído o sobrecargado.
Corrupción de la base de datos por un plugin o actualización fallida.
Cambios recientes en tu panel de control (cPanel, Plesk o Syspanel).
Problemas de permisos o de conexión remota en el hosting.
Actualización de WordPress que no se completó correctamente.

Primeros pasos: Diagnóstico rápido

Antes de entrar en soluciones técnicas, haz estas comprobaciones básicas:

1. Revisa si el error es general o solo en una página

Abre varias URLs de tu sitio. Si el error aparece en todas, el problema es global. Si solo ocurre en una página, puede ser un plugin o tema conflictivo.

2. Prueba con otro navegador o dispositivo

A veces es un problema de caché local. Si en otro navegador funciona, limpia la caché del navegador principal.

3. Verifica el estado del servidor

Contacta a tu proveedor de hosting o revisa si hay alertas en tu panel. Si el servidor de bases de datos está en mantenimiento, solo queda esperar.

Soluciones paso a paso (de lo más simple a lo más técnico)

Voy a guiarte por las soluciones más efectivas. Empieza desde la primera y avanza solo si no funciona.

1. Verifica las credenciales en wp-config.php

El archivo wp-config.php contiene los datos de acceso a la base de datos. Un error común es que se haya cambiado la contraseña desde el panel de control y no se haya actualizado aquí.

Cómo hacerlo:

Accede a tu panel de control de hosting (cPanel, Plesk o Syspanel).
Busca el Administrador de archivos o conéctate vía FTP.
Navega hasta la carpeta raíz de tu WordPress (normalmente public_html).
Localiza el archivo wp-config.php y ábrelo con un editor de texto.

Busca estas líneas:

define('DB_NAME', 'nombre_base');
define('DB_USER', 'usuario_base');
define('DB_PASSWORD', 'contraseña_base');
define('DB_HOST', 'localhost');

Compara estos valores con los que aparecen en tu panel de control (en la sección de Bases de Datos). Si no coinciden, corrígelos.
Guarda los cambios y vuelve a cargar tu web.

[TIP] Si no recuerdas la contraseña, en cPanel puedes cambiarla desde "MySQL Databases" y luego actualizar wp-config.php. En Plesk, ve a "Databases" y selecciona la base de datos.

2. Revisa el servidor de base de datos (host)

A veces el DB_HOST no es localhost. En algunos hostings compartidos puede ser una dirección IP o un nombre como mysql.tudominio.com.

¿Cómo saberlo?

En cPanel: Ve a "MySQL Databases" y busca el nombre del servidor (suele aparecer como "Server").
En Plesk: Entra en "Databases", selecciona tu base y verás el host en los detalles.
En Syspanel (HestiaCP): Accede por el puerto 2106 (ejemplo: tudominio.com:2106), ve a "Base de datos" y ahí aparece el host.

Si el host es diferente, actualiza DB_HOST en wp-config.php.

3. Repara la base de datos desde WordPress

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

Pasos:

Abre wp-config.php con un editor.
Agrega esta línea justo antes de la línea que dice /* That's all, stop editing! */:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Ve a esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
Haz clic en "Reparar base de datos" (o "Repair Database").
Una vez terminado, elimina la línea que agregaste del archivo por seguridad.

[WARNING] No dejes esa línea activa permanentemente, ya que cualquiera podría acceder a la herramienta de reparación.

4. Restablece la contraseña de la base de datos desde cPanel o Plesk

Si sospechas que la contraseña fue cambiada y no la tienes, puedes resetearla.

En cPanel:

Ve a "MySQL Databases".
Busca tu usuario de base de datos (suele tener el mismo nombre que la base).
Haz clic en "Change Password" y escribe una nueva.
Actualiza wp-config.php con esa nueva contraseña.

En Plesk:

Ve a "Databases".
Selecciona tu base de datos.
Haz clic en "Change password" (o "Cambiar contraseña").
Anota la nueva contraseña y actualiza wp-config.php.

En Syspanel (HestiaCP):

Accede por el puerto 2106.
Ve a "Base de datos" y selecciona la tuya.
Haz clic en "Editar" o "Cambiar contraseña".
Actualiza el archivo de configuración.

5. Verifica que el usuario de la base de datos tenga permisos

A veces el usuario ha perdido los privilegios sobre la base de datos.

En cPanel:

Ve a "MySQL Databases".
En la sección "Add User to Database", asegúrate de que tu usuario esté asignado a la base correcta.
Si no, agrégalo y marca todos los permisos (SELECT, INSERT, UPDATE, DELETE, etc.).

En Plesk:

Ve a "Databases".
Selecciona la base y haz clic en "Users".
Verifica que el usuario tenga todos los privilegios marcados.

6. Comprueba si hay un plugin o tema conflictivo

Si el error apareció después de instalar un plugin o cambiar de tema, puede que estén corrompiendo la conexión.

Solución temporal: Desactiva todos los plugins renombrando la carpeta plugins desde el administrador de archivos.

Ve a wp-content/plugins.
Cambia el nombre de la carpeta a plugins_old.
WordPress creará una nueva carpeta vacía automáticamente.
Si el error desaparece, ve renombrando los plugins de uno en uno hasta encontrar el culpable.

Si el error persiste, prueba con un tema por defecto (Twenty Twenty-Four) renombrando la carpeta themes de forma similar.

7. Revisa los logs del servidor

Si nada funciona, los registros de errores pueden darte pistas.

En cPanel: Ve a "Metrics" > "Errors" o "Raw Access Logs".
En Plesk: Ve a "Logs" en el panel de tu dominio.
En Syspanel: Accede por el puerto 2106 y busca "Logs" o "Registros".

Busca mensajes como "Access denied for user" o "Can't connect to MySQL server". Esto te indicará si el problema es de credenciales o de conexión al servidor.

Preguntas frecuentes (FAQ) sobre el error

¿Puedo perder mis datos si reparo la base de datos?

No, la herramienta de reparación solo corrige índices y tablas dañadas, no borra contenido. Pero siempre es recomendable hacer una copia de seguridad antes.

¿El error puede deberse a un ataque?

Sí, aunque es menos común. Si sospechas de un ataque, cambia todas las contraseñas (base de datos, WordPress, FTP) y revisa los archivos en busca de código malicioso.

¿Qué hago si el error aparece después de migrar mi web?

Seguramente las credenciales en wp-config.php no coinciden con las del nuevo hosting. Revisa paso 1.

¿Debo contactar a mi proveedor de hosting?

Si después de todas estas pruebas el error persiste, contacta al soporte técnico de tu hosting. Puede ser un problema en el servidor de bases de datos que solo ellos pueden resolver.

Consejos para prevenir el error en el futuro

Haz copias de seguridad periódicas de tu base de datos (desde cPanel, Plesk o con plugins como UpdraftPlus).
Actualiza WordPress, plugins y temas solo después de hacer un backup.
No compartas contraseñas de la base de datos ni las guardes en lugares inseguros.
Monitorea la salud de tu web con herramientas como el Health Check de WordPress.
Usa contraseñas seguras y cámbialas cada cierto tiempo.

[INFO] Si usas Syspanel (HestiaCP), recuerda que el acceso a la gestión de bases de datos se hace por el puerto 2106. Es un panel muy amigable, pero a veces los cambios en la contraseña no se reflejan automáticamente en wp-config.php, así que verifica siempre.

Resumen rápido

Causa	Solución
Credenciales incorrectas	Actualizar wp-config.php
Servidor caído	Contactar al hosting
Base de datos corrupta	Usar la herramienta de reparación
Plugin conflictivo	Desactivar plugins
Permisos de usuario	Reasignar privilegios

Espero que esta guía te haya sido de ayuda. Recuerda que la mayoría de las veces el error se soluciona con solo revisar las credenciales en wp-config.php. Si te quedas atascado, no dudes en pedir ayuda a tu proveedor de hosting o a un técnico especializado. ¡Tu web volverá a funcionar en poco tiempo!