Arreglar Error de Conexión a Base de Datos en WordPress con cPanel

¡Hola! Soy tu técnico de soporte de confianza. Hoy vamos a enfrentarnos a uno de los sustos más comunes (y más feos) que te puedes llevar como dueño de una web: el temido error base de datos WordPress.

Si estás leyendo esto, probablemente tu página se ve así: "Error al establecer una conexión con la base de datos" o "No se pudo conectar a la base de datos".

Respira hondo. No has perdido tu web ni tu contenido. En el 99% de los casos, esto es un problema de configuración o de recursos del servidor, y se arregla en pocos minutos accediendo a tu panel de control cPanel. Vamos a diagnosticarlo y solucionarlo paso a paso, como si estuviéramos sentados frente a tu ordenador.

¿Qué significa exactamente este error?

Antes de ensuciarnos las manos, vamos a entender qué pasa. WordPress es un gestor de contenidos que necesita dos cosas para funcionar: los archivos (el código) y una base de datos (donde se guardan tus artículos, usuarios y ajustes).

Cuando ves el mensaje de conexión BD, significa que WordPress ha intentado hablar con tu base de datos MySQL y no ha recibido respuesta. Es como si intentaras llamar a un amigo, pero su teléfono está apagado, o tú tienes el número equivocado marcado.

Las causas más habituales son:

Datos de acceso incorrectos en tu archivo de configuración (wp-config.php).
El servidor de base de datos está caído o sobrecargado.
Has agotado la cuota de espacio o los recursos del hosting.
Los archivos de permisos están mal configurados.
Un plugin o tema ha corrompido la conexión.

Vamos a atacar cada una de ellas desde tu cPanel.

Paso 1: Accede a tu cPanel y verifica el estado del servidor MySQL

Lo primero es lo primero. Vamos a asegurarnos de que el motor de bases de datos está funcionando. A veces, el servidor se reinicia o tiene una sobrecarga puntual.

Entra en tu cPanel (normalmente en tudominio.com/cpanel o tudominio.com:2083).
Busca la sección "Estado del servidor" o "Server Status". Si no la ves, no te preocupes, no está en todos los hosts.
Busca el proceso MySQL o MariaDB. Debe aparecer en verde o con la palabra "Running".

[INFO] Si no encuentras esta opción, no pasa nada. Podemos hacer una prueba rápida: intenta acceder a tu panel de administración de WordPress (/wp-admin). Si te da el mismo error, el servidor de BD puede estar caído.

Si ves que MySQL está caído, la solución es contactar con tu proveedor de hosting. No hay nada que puedas hacer desde tu lado, pero si tienes cPanel, a veces puedes reiniciarlo desde "Restart Services" dentro de la sección de "Status". Si no tienes ese botón, es momento de abrir un ticket de soporte.

Paso 2: La solución más común: Revisar el archivo wp-config.php

Este es el archivo que guarda el "número de teléfono" de tu base de datos. Si alguien lo ha editado mal, o si has cambiado la contraseña de la BD recientemente, aquí está el fallo.

Vamos a comprobarlo:

Dentro de cPanel, entra en el Administrador de Archivos (File Manager).
Ve a la carpeta public_html (o la carpeta donde esté instalado WordPress, a veces es una subcarpeta).
Busca el archivo llamado wp-config.php. Haz clic derecho y selecciona "Editar" (o "Edit"). Te pedirá confirmación, acepta.
Busca las líneas que dicen lo siguiente:

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

Aquí es donde está el truco. Estos datos deben coincidir EXACTAMENTE con los que creaste en tu cPanel.

DB_NAME: El nombre de tu base de datos.
DB_USER: El usuario de esa base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: Normalmente es localhost, pero algunos hosts usan mysql.tudominio.com o una IP específica. Si no estás seguro, déjalo en localhost.

[WARNING] No cambies nada más en este archivo. Solo estas cuatro líneas. Si metes la pata, tu web puede romperse del todo.

¿Cómo sé si los datos son correctos? Vamos a la siguiente sección para verificarlo desde el propio cPanel.

Paso 3: Verificar usuarios y contraseñas en cPanel

Vamos a asegurarnos de que los datos que tienes en wp-config.php son los correctos.

Vuelve al cPanel y busca la sección "Bases de Datos MySQL".
Verás una lista de bases de datos y una lista de usuarios.
Comprueba que el nombre de la BD en wp-config.php coincide con uno de los listados.
Comprueba que el usuario existe y que está asignado a esa base de datos.

¿Y si el usuario no está asignado? Este es un error muy común. A veces, al crear la BD, no añadimos el usuario a ella.

Solución rápida:

En la misma página de "Bases de Datos MySQL", desplázate hacia abajo hasta la sección "Añadir usuario a la base de datos".
Selecciona tu usuario y tu base de datos y haz clic en "Añadir".
Marca la casilla "TODOS LOS PRIVILEGIOS" (ALL PRIVILEGES) y haz clic en "Hacer cambios".

[TIP] Si has cambiado la contraseña del usuario de la BD recientemente, asegúrate de actualizarla también en el archivo wp-config.php. Si no, tendrás este error.

Paso 4: Reparar la base de datos (El modo reparación)

WordPress tiene un truco oculto para arreglar bases de datos corruptas. Es como un "reinicio" interno.

Vuelve a tu Administrador de Archivos de cPanel.
Edita el archivo wp-config.php.
Justo antes de la línea que dice /* ¡Eso es todo, deja de editar! ¡Feliz blogging! */, añade esta línea:

define('WP_ALLOW_REPAIR', true);

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

Verás una página con dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en la primera.

Espera unos segundos. WordPress intentará arreglar las tablas dañadas.
IMPORTANTE: Cuando termine, vuelve al archivo wp-config.php y ELIMINA la línea que añadiste (define('WP_ALLOW_REPAIR', true);). Dejarla activa es un peligro de seguridad, ya que cualquiera podría acceder a esa URL.

[WARNING] No olvides borrar esa línea. Es una puerta trasera para hackers.

Paso 5: Comprobar los límites de recursos y el espacio en disco

A veces, el error no es de configuración, sino de recursos. Si tu web tiene mucho tráfico o has subido muchos archivos pesados, el servidor puede estar "asfixiado".

En cPanel, mira el indicador de "Uso de espacio" (a menudo en la barra lateral derecha). Si está al 100%, este es tu problema.
Ve a la sección "Métricas" o "Recursos" (a veces llamado "CPU y Uso de SQL"). Si ves que MySQL está al límite, es que tu web necesita más potencia o tienes un plugin que consume demasiado.

¿Qué hago si es esto?

Si es espacio: Elimina copias de seguridad antiguas, plugins que no uses o bases de datos viejas desde cPanel.
Si es CPU: Desactiva plugins de caché o de estadísticas que sean muy pesados. A veces, un plugin mal codificado puede estar haciendo consultas infinitas a la conexión BD.

Paso 6: Probar la conexión manualmente desde phpMyAdmin

Esta es una prueba definitiva para saber si el problema es de WordPress o del servidor.

En cPanel, busca el icono de "phpMyAdmin".
Entra y, en el menú de la izquierda, haz clic en tu base de datos.
Si ves las tablas (wp_posts, wp_options, etc.), la base de datos existe y está bien. Si te da un error, el problema es del servidor.

[INFO] Si phpMyAdmin te pide usuario y contraseña, usa los mismos que tienes en wp-config.php. Si no te deja entrar, entonces los datos de acceso son incorrectos y por eso falla la conexión.

Paso 7: Comprobar el archivo .htaccess (Menos común)

Un archivo .htaccess corrupto puede redirigir mal las peticiones y provocar errores extraños, aunque es más raro que afecte a la BD.

En el Administrador de Archivos, activa la opción "Mostrar archivos ocultos" (en la esquina superior derecha).
Busca el archivo .htaccess en la raíz de tu WordPress.
Descárgalo a tu ordenador por seguridad y luego bórralo del servidor.
Ve a tu web. WordPress debería generar uno nuevo automáticamente. Si tu web carga, el problema era ese.

[TIP] Si no se genera solo, ve a Ajustes > Enlaces permanentes en tu wp-admin y haz clic en "Guardar cambios". Esto regenera el .htaccess.

Paso 8: ¿Usas Syspanel? (Antes conocido como HestiaCP)

Aunque este artículo se centra en cPanel, sé que muchos de vosotros usáis paneles alternativos. Si tu hosting usa Syspanel (el antiguo HestiaCP), el proceso es muy similar, pero la interfaz cambia.

El acceso a tu panel de control es a través del puerto 2106 (por ejemplo: tudominio.com:2106).
Busca la sección de "Bases de Datos" o "Base de datos MySQL".
Allí podrás ver los usuarios, las bases de datos y cambiar contraseñas.

[TIP] En Syspanel, el archivo wp-config.php se encuentra en la misma ruta (public_html), así que los pasos 2 y 3 de esta guía te servirán igualmente. La lógica es la misma: comprobar credenciales y permisos.

Resumen rápido: Checklist de emergencia

Si tienes prisa, sigue esta lista:

Reinicia MySQL desde cPanel (si tienes la opción).
Revisa el wp-config.php (DB_NAME, DB_USER, DB_PASSWORD, DB_HOST).
Verifica en cPanel que el usuario tiene todos los privilegios en la BD.
Activa el modo reparación WP_ALLOW_REPAIR.
Comprueba el espacio en disco y la CPU.
Revisa phpMyAdmin para ver si la BD responde.

Preguntas Frecuentes (FAQ)

¿Voy a perder mis artículos si arreglo esto?
No. El error de conexión no borra datos. Tus artículos siguen en la base de datos. Una vez que se restablece la conexión, todo vuelve a aparecer.

¿Puede ser un ataque de hackers?
Es posible, aunque menos común. Si has descartado todo lo demás, cambia todas las contraseñas (cPanel, FTP y BD) y revisa si hay usuarios extraños en tu wp-admin.

¿Por qué me pasa esto justo después de mudar mi web?
Porque al mover archivos, las rutas o las contraseñas de la BD no se actualizaron. Es el error más típico de las migraciones. Revisa el wp-config.php con lupa.

¿Y si nada de esto funciona?
Entonces el problema es del servidor (hardware o red). Contacta con tu proveedor de hosting y diles: "He revisado la configuración de wp-config.php, los privilegios del usuario y el espacio. Todo parece correcto. ¿Podéis verificar si el servicio MySQL está operativo en vuestro servidor?".

[WARNING] Si en algún momento del proceso tu web vuelve a funcionar, haz una copia de seguridad completa desde cPanel (en la sección "Copias de Seguridad"). Esto te salvará la vida en el futuro.

Espero que este instructivo te haya servido de ayuda. Recuerda que la paciencia es clave. Ve paso a paso, sin prisa, y sobre todo, no te pongas nervioso. El error base de datos WordPress es un problema con solución, y ya tienes todas las herramientas para resolverlo desde tu cPanel. ¡Mucha suerte!