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

Imagina que llegas a tu web y, en lugar de ver tu contenido, te encuentras con un mensaje como "Error establishing a database connection". Es frustrante, pero no te preocupes: es uno de los problemas más comunes en WordPress y, por suerte, tiene solución. Este error significa que tu sitio no puede comunicarse con la base de datos donde se almacenan tus entradas, páginas, usuarios y configuraciones.

En esta guía, te explicaré paso a paso cómo solucionar el error base de datos WordPress. Vamos a revisar desde lo más simple (como reiniciar servicios) hasta la edición de archivos de configuración. Incluso si no eres una persona técnica, podrás seguir estas instrucciones con ayuda de tu cPanel base de datos o de herramientas como Syspanel (el panel de control que antes se llamaba HestiaCP, accesible por el puerto 2106).

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

Antes de ponernos manos a la obra, es útil entender por qué ocurre. Las causas más frecuentes son:

Credenciales incorrectas en el archivo wp-config.php.
El servidor de base de datos está caído o no responde.
La base de datos ha sido dañada (corrupción de tablas).
Problemas con el hosting (límites de conexiones, mantenimiento, etc.).
Cambios recientes (migración, cambio de contraseñas, plugins conflictivos).

[INFO] La mayoría de las veces, el error se soluciona verificando los datos de acceso en el archivo de configuración. Pero si eso no funciona, iremos revisando otras causas.

Paso 1: Verifica el estado del servidor de base de datos

Lo primero es asegurarte de que el servidor de bases de datos (MySQL o MariaDB) esté funcionando. Si estás en un hosting compartido, esto suele ser responsabilidad de tu proveedor, pero puedes verificarlo.

Si usas cPanel

Accede a tu cPanel (normalmente en tudominio.com/cpanel).
Busca la sección Bases de datos y haz clic en phpMyAdmin.
Si phpMyAdmin se abre y ves tus bases de datos, el servidor está activo. Si no, contacta con soporte.

Si usas Syspanel (HestiaCP)

Abre tu navegador y escribe https://tudominio.com:2106 (puerto 2106).
Inicia sesión con tus credenciales de administrador.
Ve a Base de datos y revisa si tu base de datos aparece en la lista. Si no ves nada, el servicio podría estar detenido.

[WARNING] Si no puedes acceder a ningún panel, contacta a tu proveedor de hosting. El problema puede estar en su infraestructura.

Paso 2: Revisa las credenciales en el archivo wp-config.php

Este es el paso más común para solucionar error WordPress. El archivo wp-config.php contiene los datos de conexión: nombre de la base de datos, usuario, contraseña y servidor. Si alguno de estos cambió (por ejemplo, tras un cambio de contraseña en cPanel), el error aparece.

¿Cómo acceder al archivo?

Puedes hacerlo desde el panel de control o mediante FTP (FileZilla, por ejemplo). Te muestro ambas opciones:

Desde cPanel

Entra a cPanel y busca la sección Archivos > Administrador de archivos.
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta).
Busca el archivo wp-config.php. Si no lo ves, asegúrate de que estén visibles los archivos ocultos (hay un botón en la parte superior).
Haz clic derecho y selecciona Editar.

Desde Syspanel

Accede a https://tudominio.com:2106.
Ve a Archivos > Administrador de archivos.
Localiza el archivo wp-config.php en la raíz de tu sitio.
Edítalo con el editor de texto integrado.

¿Qué debes revisar?

Dentro del archivo, busca estas líneas (aproximadamente en la línea 20):

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');

DB_NAME: Debe coincidir exactamente con el nombre de tu base de datos en cPanel/Syspanel.
DB_USER: El usuario asociado a esa base de datos.
DB_PASSWORD: La contraseña actual de ese usuario. Si la cambiaste recientemente, actualízala aquí.
DB_HOST: Casi siempre es localhost, pero algunos proveedores usan algo como mysql.tudominio.com. Verifica en la documentación de tu hosting.

[TIP] Si no recuerdas la contraseña, puedes cambiarla desde cPanel (en Bases de datos MySQL > Usuarios) o desde Syspanel (en Base de datos > Editar usuario). Luego actualiza el archivo.

Una vez corregido, guarda los cambios y recarga tu web. Si el error persiste, continúa con el siguiente paso.

Paso 3: Repara la base de datos (puede estar dañada)

A veces, las tablas de la base de datos se corrompen por cortes de energía, errores de escritura o plugins defectuosos. WordPress incluye un modo de reparación automática.

Activar el modo de reparación

Accede a tu archivo wp-config.php (como en el paso anterior).
Justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */, agrega esta línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ahora, en tu navegador, visita: https://tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos opciones: Reparar base de datos y Reparar y optimizar base de datos. Haz clic en la primera (o en la segunda si quieres optimizar también).
El proceso puede tardar unos segundos. Al finalizar, verás un mensaje de éxito o errores específicos.

[WARNING] Después de reparar, no olvides eliminar la línea que agregaste en wp-config.php. Si la dejas, cualquiera podría reparar tu base de datos sin autorización. Simplemente bórrala y guarda el archivo.

Si la reparación no funciona, es posible que necesites usar herramientas más avanzadas como phpMyAdmin para reparar tablas manualmente.

Reparar con phpMyAdmin

Desde cPanel o Syspanel, abre phpMyAdmin.
Selecciona tu base de datos en la columna izquierda.
Verás una lista de tablas. Marca todas (con el checkbox superior).
En el menú desplegable Con seleccionados, elige Reparar tabla.
Espera a que termine. Si alguna tabla no se repara, anota su nombre para investigar.

Paso 4: Verifica los límites de conexiones y el hosting

Si tu sitio recibe mucho tráfico o tu plan de hosting es muy básico, podrías estar alcanzando el límite de conexiones simultáneas a la base de datos. Esto también genera el error de conexión.

¿Cómo saber si es por límites?

Revisa si el error aparece en momentos de mucho tráfico.
Consulta los logs de error de tu hosting (en cPanel: Métricas > Errores; en Syspanel: Registros > Errores del sistema).
Busca mensajes como "Too many connections".

Soluciones posibles

Actualiza tu plan de hosting a uno con más recursos.
Optimiza tu base de datos: elimina revisiones de entradas, spam de comentarios, transients obsoletos. Puedes usar plugins como WP-Optimize o Advanced Database Cleaner.
Instala un plugin de caché (como W3 Total Cache o WP Super Cache) para reducir las consultas a la base de datos.

[INFO] Si el problema persiste incluso con poco tráfico, contacta a tu proveedor de hosting. Pueden tener un problema en el servidor de bases de datos.

Paso 5: Restaura una copia de seguridad reciente

Si nada de lo anterior funciona, es posible que el archivo wp-config.php o la base de datos estén dañados de forma irreversible. En ese caso, lo mejor es restaurar desde una copia de seguridad.

Desde cPanel

Ve a Archivos > Administrador de archivos y busca una copia de seguridad de tu sitio (normalmente en una carpeta como backup o copias).
Si tienes una copia de la base de datos (archivo .sql), puedes importarla desde phpMyAdmin:
- Selecciona tu base de datos.
- Haz clic en Importar.
- Elige el archivo .sql y haz clic en Continuar.

Desde Syspanel

En el panel, ve a Copia de seguridad.
Selecciona la restauración más reciente de tu sitio.
Confirma la operación. Esto reemplazará tanto archivos como base de datos.

[WARNING] Restaurar una copia de seguridad borrará todos los cambios realizados después de esa fecha. Asegúrate de tener una copia reciente y de que no perderás información crítica.

Preguntas frecuentes (FAQ)

¿Por qué aparece el error después de cambiar la contraseña de la base de datos?

Es muy común. Al cambiar la contraseña desde cPanel o Syspanel, debes actualizarla también en el archivo wp-config.php. Si no lo haces, WordPress usará la contraseña antigua y fallará la conexión.

¿Puedo solucionar el error sin acceso al panel de control?

Si no puedes acceder a cPanel ni a Syspanel, pero tienes acceso FTP, puedes editar el archivo wp-config.php desde un cliente FTP (como FileZilla). Descarga el archivo, edítalo con un editor de texto (Bloc de notas, Sublime Text) y súbelo de nuevo.

¿El error puede deberse a un plugin o tema?

Sí, aunque es menos frecuente. Si el error apareció justo después de instalar un plugin o tema, desactívalos. Puedes hacerlo renombrando la carpeta del plugin desde FTP (por ejemplo, de plugins a plugins_desactivado). Si el error se soluciona, ese plugin es el culpable.

¿Qué hago si el servidor de base de datos está caído?

Si tu proveedor de hosting tiene una caída general, no puedes hacer nada más que esperar. Contacta a soporte y pregunta cuándo se restablecerá el servicio. Mientras tanto, puedes poner un mensaje de mantenimiento en tu web (si tienes acceso a archivos, crea un archivo maintenance.html).

¿Es seguro usar el modo de reparación de WordPress?

Sí, pero solo debe activarse temporalmente. Una vez reparada la base de datos, elimina la línea que agregaste en wp-config.php para evitar riesgos de seguridad.

Conclusión

El error de conexión a la base de datos en WordPress puede parecer grave, pero en la mayoría de los casos se resuelve con pasos sencillos: verificar credenciales, reparar la base de datos o contactar al hosting. Recuerda que siempre debes tener copias de seguridad actualizadas para evitar pérdidas de información.

Si has seguido todos los pasos y el error persiste, no dudes en contactar al soporte técnico de tu proveedor de hosting. Ellos tienen acceso directo a los servidores y pueden identificar problemas que tú no puedes ver desde el panel.

Espero que esta guía te haya sido útil. ¡Tu sitio web volverá a funcionar en poco tiempo!