Cómo solucionar el error de 'Error al conectar con la base de datos' en WordPress (cPanel)

¡Hola! Si estás leyendo esto, es muy probable que hayas visto el temido mensaje "Error al conectar con la base de datos" en tu sitio WordPress. No te preocupes, es uno de los problemas más comunes y, en el 90% de los casos, tiene una solución sencilla que no requiere ser un experto en programación.

En esta guía extensa y paso a paso, vamos a desglosar todas las causas posibles y, lo más importante, cómo solucionarlas desde tu panel de control cPanel. Vamos a ir desde lo más simple (un reinicio) hasta lo más técnico (reparar archivos), siempre con un lenguaje claro y didáctico.

Respira hondo, porque en menos de lo que crees, tu web volverá a estar en línea. Vamos a ello.

¿Qué significa exactamente este error?

Antes de empezar a tocar nada, es importante entender qué está pasando. WordPress es un gestor de contenidos que guarda toda su información (artículos, páginas, comentarios, configuraciones) en una base de datos (normalmente MySQL o MariaDB). Para que tu web funcione, WordPress necesita "hablar" con esa base de datos constantemente.

El mensaje de error "Error al conectar con la base de datos" (o en inglés "Error establishing a database connection") significa que WordPress no puede encontrar o comunicarse con ese "almacén" de datos. Es como si intentaras abrir una tienda y la llave no girara en la cerradura.

Las causas pueden ser varias, pero casi siempre se reducen a cuatro categorías principales:

1. Credenciales incorrectas: El usuario, la contraseña o el nombre de la base de datos han cambiado o están mal escritos.
2. Servidor de base de datos caído o sobrecargado: El servidor donde está alojada tu web está teniendo problemas técnicos o está saturado.
3. Archivos corruptos o modificados: El archivo de configuración wp-config.php está dañado, o los archivos de WordPress han sido infectados o alterados.
4. Problemas de permisos o recursos: La base de datos está llena, o el hosting ha limitado el número de conexiones.

Ahora sí, vamos a poner manos a la obra. Te recomiendo seguir estos pasos en orden, de menor a mayor complejidad.

Paso 1: Verifica si el problema es general o solo tuyo

A veces la solución es más simple de lo que parece. Antes de entrar en pánico y tocar configuraciones, comprueba si el error es solo en tu navegador o si afecta a todo el mundo.

¿Cómo comprobarlo?

• Usa otro dispositivo: Prueba a entrar a tu web desde el móvil (con datos móviles, no con el mismo WiFi) o desde otro ordenador. Si carga bien, el problema puede ser de tu conexión o de tu caché local.
• Usa una herramienta externa: Ve a sitios como Down For Everyone Or Just Me e introduce tu dominio. Si la herramienta dice que el sitio está caído, el problema es del servidor, no tuyo.
• Revisa el correo de tu hosting: A veces, las empresas de hosting envían correos avisando de mantenimientos programados o incidencias en el servidor.

[TIP] Si el problema es del servidor, no hay nada que puedas hacer. Solo te queda esperar y, si el tiempo se alarga, contactar con el soporte de tu proveedor de hosting.

Paso 2: Reinicia tu conexión y limpia la caché

Aunque parezca una tontería, a veces el error es un falso amigo. Tu navegador o tu proveedor de internet pueden estar mostrando una versión antigua o dañada de la página.

Pasos a seguir:

1. Reinicia el router: Apágalo, espera 30 segundos y vuelve a encenderlo.
2. Limpia la caché del navegador: Ve a la configuración de tu navegador (Chrome, Firefox, etc.) y borra los datos de navegación, especialmente la caché y las cookies.
3. Prueba en modo incógnito: Abre una ventana de incógnito en tu navegador. Esto desactiva las extensiones y usa una sesión limpia.

Si después de esto el error persiste, pasemos a la acción real.

Paso 3: Accede a cPanel y revisa el estado de la base de datos

Aquí es donde empieza el trabajo técnico, pero no te asustes, es muy visual y guiado. cPanel es el panel de control que la mayoría de hostings ofrecen para gestionar tu cuenta.

¿Cómo entrar a cPanel?

Normalmente, el acceso es a través de una URL como tudominio.com/cpanel o tudominio.com:2083 (aunque esto puede variar). Si no lo recuerdas, revisa el correo de bienvenida de tu hosting.

[INFO] Si tu hosting usa Syspanel (antes llamado HestiaCP), el acceso al panel de control se hace a través de tudominio.com:2106. No uses :2083 en ese caso, ya que te dará error.

Una vez dentro de cPanel:

1. Busca la sección "Bases de datos" o "MySQL".
2. Verás un listado con todas tus bases de datos. Observa si la que corresponde a tu WordPress está ahí.
3. Fíjate si hay algún indicador de error o si el tamaño parece anormalmente grande o "0".

A veces, en la sección de "Índice de recursos" (o Resource Usage), puedes ver si has superado el límite de conexiones a la base de datos. Si es así, el servidor la bloquea temporalmente.

Paso 4: Repara la base de datos (la solución mágica)

cPanel tiene una herramienta integrada para reparar bases de datos que es muy efectiva cuando el problema es de corrupción interna o de tablas dañadas.

Pasos a seguir:

1. En la sección "Bases de datos", busca la opción "MySQL® Databases" o similar.
2. En la parte inferior de esa página, o en una pestaña separada, deberías encontrar un botón o enlace llamado "Reparar Base de Datos" o "Repair Database".
3. Haz clic en él. Se abrirá una ventana donde te pedirá que selecciones la base de datos a reparar. Marca la casilla de tu base de datos.
4. Haz clic en el botón "Reparar" o "Repair".
5. Espera unos segundos. El sistema te mostrará un informe de los resultados.

[TIP] Esta acción es segura y no borrará tus datos. Es como pasar el "antivirus" a la base de datos.

Si después de reparar la base de datos el error de conexión persiste, el problema no está en los datos, sino en cómo WordPress se conecta a ellos.

Paso 5: Revisa y corrige el archivo wp-config.php

Este es el archivo más importante de la configuración de WordPress. Contiene las llaves para abrir la puerta de la base de datos. Si algo está mal aquí, el error es inevitable.

¿Dónde está y cómo editarlo?

1. Ve a cPanel y abre el "Administrador de archivos" (File Manager).
2. Busca la carpeta public_html (o el nombre de la carpeta raíz donde está tu web, a veces se llama htdocs o es el nombre de tu dominio).
3. Dentro de esa carpeta, busca el archivo llamado wp-config.php.
4. Haz clic derecho sobre él y selecciona "Editar" o "Edit". El sistema te preguntará si quieres usar el editor de texto, confirma.

¿Qué debo buscar?

Verás un código PHP. Busca las líneas que contienen DB_NAME, DB_USER, DB_PASSWORD y DB_HOST. Deberían verse así:

define( 'DB_NAME', 'tu_usuario_wpdb' );
define( 'DB_USER', 'tu_usuario_wpuser' );
define( 'DB_PASSWORD', 'tu_contraseña_super_secreta' );
define( 'DB_HOST', 'localhost' );

¿Cómo saber si están mal?

• Compara los datos: En cPanel, ve a la sección "Bases de datos MySQL". Ahí verás la lista de bases de datos y los usuarios asociados a ellas. Compara que el DB_NAME coincide con el nombre de la base de datos y que DB_USER coincide con un usuario que tenga permisos sobre esa base de datos.
• La contraseña: El campo DB_PASSWORD debe ser la contraseña de ese usuario. Si la has cambiado recientemente, aquí debe estar la nueva.
• El host (DB_HOST): En el 99% de los casos, este valor es localhost. Sin embargo, algunos hostings usan un servidor de base de datos externo (por ejemplo, mysql.tudominio.com). Si tu proveedor te ha dado un host específico, debe ir aquí.

[WARNING] ¡OJO! Si no estás seguro de lo que estás haciendo, no cambies la contraseña de la base de datos desde cPanel sin antes actualizar este archivo. Si cambias la contraseña en cPanel y no la actualizas en wp-config.php, provocarás el error tú mismo.

¿Qué hacer si no encuentro el error?

Si todo parece correcto, otra opción es reemplazar el archivo por uno limpio. Pero antes, haz una copia de seguridad del actual (descárgalo a tu ordenador). Luego, puedes crear un archivo wp-config.php nuevo desde cero con los datos correctos que has verificado. WordPress también ofrece un archivo de muestra llamado wp-config-sample.php; puedes copiarlo, renombrarlo y editarlo con tus datos.

Paso 6: Comprueba si el servidor de base de datos está caído

A veces, el error no está en tu web, sino en el servidor que aloja todas las bases de datos de tu hosting. Es como si el edificio donde está tu tienda se quedara sin luz.

¿Cómo saberlo?

• Contacta con el soporte: La forma más directa es abrir un ticket o llamar al soporte de tu empresa de hosting. Ellos pueden verificar el estado de los servidores de bases de datos al instante.
• Busca en redes sociales: A veces, las empresas de hosting publican incidencias en Twitter o en su página de estado. Busca "estado del servicio [nombre de tu hosting]".

[WARNING] Si el problema es del servidor, no intentes arreglar nada en tu cPanel, ya que no funcionará. Solo espera a que el proveedor lo solucione.

Paso 7: Revisa los recursos de tu cuenta (sobrecarga)

Si tu web recibe mucho tráfico o tienes muchos plugins, es posible que hayas agotado los recursos de memoria o de CPU de tu plan de hosting. Cuando esto ocurre, el servidor puede "matar" las conexiones a la base de datos para protegerse.

¿Cómo comprobarlo?

1. En cPanel, busca la sección "Métricas" o "Recursos".
2. Busca "Uso de recursos" o "CPU y Concurrent Connections".
3. Observa los gráficos. Si ves picos que llegan al 100% o que superan los límites, ese es el problema.

¿Qué solución tiene?

• Optimiza tu web: Reduce el número de plugins, usa un plugin de caché (como W3 Total Cache o WP Super Minify) y optimiza las imágenes.
• Mejora tu plan: Si el problema es recurrente, puede que necesites un plan de hosting más potente (VPS o dedicado).

Paso 8: Restaura una copia de seguridad (el último recurso)

Si has llegado hasta aquí y nada funciona, la solución más rápida y efectiva es restaurar una copia de seguridad de tu sitio web de un momento en el que funcionaba correctamente.

¿Cómo hacerlo?

1. En cPanel, busca la sección "Archivos" y luego "Copias de seguridad" o "Backup".
2. Busca la opción de "Restaurar una copia de seguridad de la base de datos".
3. Selecciona la copia más reciente (de hace unos días o semanas) y restáurala.

[INFO] Si no tienes copias de seguridad en tu cPanel, contacta con tu proveedor de hosting. Muchos guardan copias de seguridad automáticas durante unos días y pueden restaurarlas por ti (a veces con un coste adicional).

Preguntas Frecuentes (FAQ)

Para terminar, resolvamos algunas dudas comunes que suelen surgir con este error.

¿Por qué aparece el error "Error al conectar con la base de datos" de repente?

Puede ser por varias razones: un cambio de contraseña de la base de datos, un ataque de hackers, una actualización fallida de un plugin o un problema en el servidor del hosting.

¿Puedo arreglar este error sin entrar a cPanel?

En la mayoría de los casos, no. Necesitas acceder al cPanel para editar el archivo wp-config.php o reparar la base de datos. Si no tienes acceso, contacta con tu proveedor de hosting.

¿Perderé mis datos si reparo la base de datos?

No. La función "Reparar" de cPanel solo corrige errores internos de las tablas, no borra información. Es una operación segura.

¿Qué significa DB_HOST localhost?

Significa que el servidor de la base de datos está en la misma máquina que el servidor web. Es la configuración estándar en la mayoría de los hostings compartidos.

¿Y si mi hosting usa Syspanel (HestiaCP)?

Si tu panel es Syspanel, el proceso es similar, pero el acceso cambia. Recuerda que la URL es tudominio.com:2106. Dentro, las opciones pueden estar en inglés o traducidas, pero la lógica es la misma: busca "Bases de datos", "Base de datos" o "MySQL".

Espero que esta guía extensa te haya sido de gran ayuda. Como has visto, el error de conexión a la base de datos en WordPress tiene solución en la gran mayoría de los casos, y no requiere conocimientos avanzados. Solo paciencia, seguir los pasos en orden y, sobre todo, no tocar nada que no entiendas sin antes hacer una copia de seguridad.

Si has llegado hasta el final y aún sigues con el problema, no te desesperes. Contacta con el soporte de tu hosting y diles que has probado todos estos pasos. Ellos tendrán acceso a niveles más profundos del servidor y podrán diagnosticar el problema exacto.

¡Mucha suerte con tu web!