Error de conexión a base de datos WordPress: Solución en cPanel y Plesk

¡Hola! Si estás leyendo esto, seguramente te has encontrado con uno de los sustos más comunes (y molestos) del mundo WordPress: "Error al establecer una conexión con la base de datos" o el famoso "Error de conexión a la base de datos".

No te preocupes. En la mayoría de los casos, esto no significa que hayas perdido tu sitio web. Tu contenido y tus archivos siguen ahí, intactos. Simplemente hay un "cable suelto" entre WordPress y su almacén de datos (la base de datos).

En esta guía extensa y paso a paso, vamos a desglosar cómo solucionar el error de conexión a la base de datos en WordPress, tanto si usas cPanel como Plesk o Syspanel. Vamos a ir desde lo más simple hasta lo más técnico, para que cualquier persona, aunque no sea experta, pueda intentar arreglarlo.

¿Qué significa exactamente este error?

Cuando ves el mensaje "Error al establecer una conexión con la base de datos", significa que WordPress no puede comunicarse con el servidor donde se guardan tus entradas, páginas, comentarios y configuraciones.

Piensa en ello como un edificio de apartamentos: WordPress es la puerta de entrada, y la base de datos es el piso donde vive toda tu información. Si la puerta está rota o el portero no te deja pasar, no puedes ver a los inquilinos (tu contenido).

Las causas suelen ser cuatro:

Datos de acceso incorrectos en el archivo de configuración (wp-config.php).
El servidor de la base de datos está caído o sobrecargado.
La base de datos ha sido dañada o eliminada.
Problemas de permisos o de caché (tanto en el hosting como en el navegador).

Vamos a atacar cada una de estas causas en orden de probabilidad.

Fase 1: Verificar el archivo de configuración (wp-config.php)

Esta es la causa más común y la más fácil de revisar. El archivo wp-config.php contiene las "llaves" de acceso a tu base de datos. Si estas llaves no coinciden con las reales, WordPress no conecta base datos.

¿Cómo encontrar este archivo?

Necesitas acceder a tu panel de control de hosting (cPanel, Plesk o Syspanel).

Abre el Administrador de Archivos (File Manager) en tu panel.
Navega hasta la carpeta donde está instalado WordPress. Normalmente es public_html (en cPanel) o httpdocs (en Plesk). Si tu sitio está en una subcarpeta (ej. /blog), entra ahí.
Busca el archivo llamado wp-config.php. Haz clic derecho sobre él y selecciona Editar o Edit.

¿Qué debo comprobar?

Dentro del archivo, verás líneas de código que empiezan con define. Busca estas cuatro líneas:

define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Aquí tienes que verificar que:

DB_NAME: El nombre de la base de datos es correcto.
DB_USER: El usuario es el correcto.
DB_PASSWORD: La contraseña es la correcta (cuidado con espacios o caracteres extraños).
DB_HOST: Generalmente es localhost, pero algunos hosts usan direcciones como mysql.tudominio.com o 127.0.0.1.

[TIP]: Si no recuerdas tus credenciales, no las inventes. Ve a tu panel de control de hosting y busca la sección de "Bases de Datos MySQL" o "MySQL Databases". Ahí verás el nombre de la base y el usuario. Si no sabes la contraseña, cámbiala desde el panel, pero ojo: si la cambias, debes actualizar este archivo wp-config.php con la nueva contraseña.

Fase 2: Acceso a la base de datos desde el panel de control

A veces el problema no es el archivo, sino que el propio servidor de bases de datos está caído o bloqueado. Vamos a comprobarlo.

Si usas cPanel (o Syspanel)

Inicia sesión en tu panel de control.
Busca la sección Bases de Datos y haz clic en phpMyAdmin.
Si phpMyAdmin se abre y puedes ver tus bases de datos en el menú lateral izquierdo, significa que el servidor de bases de datos está funcionando.
Haz clic en tu base de datos (la que indicaste en DB_NAME) para ver sus tablas.

[INFO]: Si estás usando Syspanel (el antiguo HestiaCP), el proceso es idéntico, pero el acceso al panel se realiza a través del puerto 2106. Por ejemplo: https://tudominio.com:2106. Dentro, busca el icono de "phpMyAdmin" o "DB".

¿Qué hago si veo un error en phpMyAdmin?

Si al intentar entrar a phpMyAdmin te sale un error, el problema es del servidor. En ese caso:

Contacta con tu proveedor de hosting inmediatamente.
Diles: "Mi sitio WordPress no conecta base datos y phpMyAdmin no abre". Ellos sabrán reiniciar el servicio MySQL/MariaDB.

[WARNING]: No intentes reiniciar el servidor de bases de datos desde tu panel si no sabes lo que haces. En cPanel, a veces hay una opción "Restart MySQL" en la sección de "Múltiples instancias" o similar, pero úsala solo si tu proveedor te lo indica.

Fase 3: Reparar la base de datos dañada

Si phpMyAdmin abre y ves las tablas, pero WordPress sigue sin funcionar, puede que la base de datos esté dañada. Esto suele pasar tras cortes de energía o errores del servidor.

WordPress tiene una herramienta oculta para reparar bases de datos. Vamos a activarla.

Pasos para activar el modo de reparación:

Vuelve al archivo wp-config.php que editamos antes.
Busca la línea que dice define('WP_DEBUG', false); o similar.
Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */ (o al final del archivo), añade esta línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
Ahora, en tu navegador, ve a esta URL: https://tudominio.com/wp-admin/maint/repair.php

Verás una página con dos botones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en el primero para empezar.

Espera a que termine. Si encuentra errores, los arreglará.
IMPORTANTE: Cuando termine, borra la línea que añadiste (define('WP_ALLOW_REPAIR', true);) del archivo wp-config.php. Dejarla activa es un riesgo de seguridad enorme, ya que cualquiera podría intentar reparar tu web.

Fase 4: Comprobar el usuario y los privilegios de la base de datos

A veces, la base de datos existe y el servidor funciona, pero el usuario que usamos no tiene permisos para acceder a ella. Esto pasa mucho al migrar sitios web.

En cPanel:

Ve a la sección Bases de Datos MySQL.
Busca la sección que dice "Añadir Usuario a Base de Datos" (o "Add User to Database").
Asegúrate de que el usuario que usas en wp-config.php esté asignado a la base de datos que usas.
Si no está, añádelo. En el paso de "Privilegios", selecciona TODOS LOS PRIVILEGIOS (ALL PRIVILEGES) y haz clic en "Hacer cambios".

En Plesk:

Ve a Sitios web y dominios.
En la sección de bases de datos, haz clic en el nombre de tu base de datos.
Verás la lista de usuarios. Asegúrate de que el usuario correcto está en la lista y tiene marcada la casilla de "Todos los privilegios" o similar.

[TIP]: Si estás en Syspanel (puerto 2106), busca la sección de "Bases de datos" y edita los permisos del usuario. La interfaz es muy similar a Plesk.

Fase 5: El problema del "DB_HOST" (Servidor de base de datos)

Como mencionamos antes, el DB_HOST no siempre es localhost. En hosts como WP Engine, Kinsta o algunos servidores dedicados, la base de datos está en un servidor separado.

Si tu hosting te dio una dirección específica (algo como db.internal.miempresa.com), debes ponerla en DB_HOST.
Si usas localhost y no funciona, prueba a cambiarlo por 127.0.0.1. A veces el servidor no resuelve el nombre "localhost" pero sí la IP.

[INFO]: En Syspanel (HestiaCP), el host suele ser localhost en el 99% de los casos, pero si tienes dudas, revisa el correo de bienvenida de tu proveedor de hosting.

Fase 6: Limpiar la caché (del navegador y del servidor)

A veces el error es un "fantasma". Tu base de datos está bien, pero el navegador o el servidor guardaron una copia del error.

Limpiar caché del navegador:

Abre el modo incógnito en tu navegador (Ctrl + Shift + N en Chrome, Ctrl + Shift + P en Firefox).
Escribe tu dominio y mira si el error persiste. Si no aparece, es caché del navegador.

Limpiar caché del servidor:

Si usas un plugin de caché (como W3 Total Cache o WP Super Cache), a veces el archivo de caché se corrompe.
Para limpiarlo sin entrar en WordPress, puedes usar el Administrador de Archivos de tu panel (cPanel, Plesk o Syspanel).
Navega a la carpeta wp-content y luego a cache. Borra todo el contenido de esa carpeta (no la carpeta en sí).

[WARNING]: No borres la carpeta uploads dentro de wp-content, solo la carpeta cache (si existe). Si no ves una carpeta llamada cache, es que tu plugin usa otro método de almacenamiento.

Fase 7: Revisar los límites de memoria de PHP

Si el error es intermitente (a veces funciona, a veces no), puede ser un problema de memoria. WordPress necesita memoria para ejecutar las consultas a la base de datos.

Aumentar la memoria:

Añade esta línea a tu archivo wp-config.php, justo antes de la línea final:

define('WP_MEMORY_LIMIT', '256M');

Esto le da más memoria a WordPress para procesar las peticiones. Si el error desaparece, el problema era la falta de recursos.

Fase 8: Verificar que la base de datos no esté llena

Este es un error poco común pero muy real. Si tu base de datos alcanza el límite de espacio permitido por tu plan de hosting, WordPress no podrá escribir ni leer datos, dando como resultado un error de conexión (aunque en realidad es un error de escritura).

En cPanel, ve a Bases de datos MySQL y mira el tamaño de tu base de datos.
Si está cerca del 100% de tu cuota, necesitas eliminar datos (como comentarios spam o revisiones de entradas) o contratar más espacio.

Fase 9: ¿Y si nada de esto funciona? (Restaurar copia de seguridad)

Si has llegado hasta aquí y sigues viendo el error base de datos wordpress, es hora de tomar medidas drásticas.

Ve a tu panel de control (cPanel, Plesk o Syspanel).
Busca la sección de Copias de Seguridad (Backups).
Restaura una copia de seguridad de la base de datos de una fecha anterior a cuando empezó el problema.

[TIP]: Si no tienes una copia de seguridad en tu hosting, revisa si tu proveedor hace backups automáticos diarios. Muchos lo hacen, pero solo los guardan durante 7 días.

Restaurar solo la base de datos (método manual):

Si tienes un archivo .sql de tu base de datos:

Entra en phpMyAdmin.
Selecciona tu base de datos.
Ve a la pestaña Importar.
Sube el archivo .sql y haz clic en "Continuar".

Esto sobrescribirá la base de datos actual con la copia de seguridad.

Preguntas Frecuentes (FAQ)

¿Por qué mi WordPress no conecta base datos después de un cambio de contraseña?

Porque el archivo wp-config.php sigue teniendo la contraseña antigua. Repite la Fase 1 de esta guía para actualizar la contraseña en el archivo.

¿Es peligroso activar el modo de reparación?

Solo si lo dejas activado. Úsalo, repara, y desactívalo inmediatamente después. Es una puerta trasera para hackers.

¿El error puede deberse a un plugin?

Sí, aunque es menos común. Si el error empezó justo después de instalar un plugin, intenta desactivarlo. Como no puedes entrar en WordPress, hazlo desde phpMyAdmin: entra en tu base de datos, busca la tabla wp_options y cambia el valor de active_plugins a a:0:{}. Esto desactiva todos los plugins.

¿Qué significa "One or more database tables are unavailable"?

Significa que las tablas de tu base de datos están corruptas o no existen. Usa la Fase 3 (modo de reparación) para intentar arreglarlas.

Si uso Syspanel (HestiaCP), ¿cambio algo?

La lógica es la misma. Solo cambia la forma de acceder al panel. Recuerda que debes usar el puerto 2106 (ej: https://tudominio.com:2106) para acceder a Syspanel. Los pasos de archivos y bases de datos son idénticos a Plesk.

Conclusión final

Solucionar el error de conexión a la base de datos en WordPress es un proceso de eliminación. Empieza siempre por lo más simple (el archivo de configuración) y ve subiendo en complejidad.

Recuerda el orden lógico:

Revisa el wp-config.php (credenciales).
Comprueba que el servidor MySQL funciona (phpMyAdmin).
Repara la base de datos (modo reparación).
Verifica permisos (usuario asignado).
Limpia cachés.
Restaura una copia de seguridad.

Con paciencia, siguiendo estos pasos, recuperarás tu sitio web. No te desesperes; es un problema con solución en el 99% de los casos. ¡Mucha suerte!