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

¡Hola! Soy tu asistente técnico. Hoy vamos a resolver uno de los sustos más comunes al administrar una web en WordPress: el temido error de conexión a la base de datos. Si ves un mensaje como "Error establishing a database connection" o "Error de conexión a la base de datos", no te preocupes. En esta guía paso a paso, con cPanel y un poco de paciencia, lo solucionaremos. Vamos a ello.

¿Qué significa este error y por qué aparece?

Cuando visitas tu web y aparece el mensaje de error, significa que WordPress no puede comunicarse con la base de datos donde se almacenan tus entradas, páginas, usuarios y configuraciones. Es como si tu casa (la web) no pudiera abrir la puerta del sótano donde guardas todas tus cosas.

Las causas más frecuentes son:

Datos incorrectos en el archivo de configuración de WordPress (wp-config.php).
Que el usuario o la contraseña de la base de datos hayan cambiado (por ejemplo, tras un cambio de hosting o una restauración).
Que la base de datos esté caída o corrupta.
Que el servidor de bases de datos (MySQL) esté sobrecargado o no funcione.
Un plugin o tema mal configurado que haya alterado la conexión.

Vamos a revisar cada posible causa, desde lo más simple a lo más técnico, usando las herramientas de cPanel.

[INFO] Si tu web muestra este error, no te asustes. Lo más probable es que sea un error de configuración y no de pérdida de datos. Tus contenidos siguen intactos en la base de datos.

Paso 1: Verifica que tu base de datos y usuario existan en cPanel

Lo primero es asegurarnos de que la base de datos y el usuario que WordPress intenta usar realmente existen. Para ello, accede a tu panel de control cPanel.

Accede a cPanel y busca la sección "Bases de Datos"

Inicia sesión en cPanel con tus credenciales (normalmente las proporciona tu proveedor de hosting).
Busca la sección Bases de Datos. Allí verás herramientas como "Bases de Datos MySQL" y "Usuarios MySQL".

Revisa la base de datos

Haz clic en "Bases de Datos MySQL".
Aparecerá una lista con todas las bases de datos de tu cuenta. Busca el nombre que debería estar usando tu WordPress. Si no sabes cuál es, más adelante lo veremos en el archivo wp-config.php.
Si la base de datos no aparece, puedes crearla desde cero (pero antes, asegúrate de que no se haya borrado por error).

Revisa el usuario de la base de datos

Ve a "Usuarios MySQL".
Verifica que el usuario que WordPress utiliza existe y que tiene todos los privilegios sobre la base de datos correcta.
Si el usuario no existe, créalo y asígnale todos los privilegios (marca "TODOS LOS PRIVILEGIOS") a la base de datos correspondiente.

[WARNING] Si creas un nuevo usuario o base de datos, recuerda que luego deberás actualizar el archivo wp-config.php con los nuevos datos. No lo hagas si no es necesario.

Paso 2: Revisa el archivo wp-config.php

Este es el archivo más importante para la conexión. Contiene el nombre de la base de datos, el usuario, la contraseña y el servidor. Un error tipográfico aquí y todo falla.

Localiza y edita wp-config.php

Desde cPanel, ve a "Administrador de Archivos" (normalmente en la sección "Archivos").
Busca la carpeta donde está instalado WordPress (suele ser public_html o una subcarpeta).
Dentro, busca el archivo wp-config.php. Haz clic derecho y selecciona "Editar" (o "Code Editor").

Verifica las cuatro líneas clave

Dentro del archivo, busca estas líneas (pueden estar en cualquier orden, pero normalmente al principio):

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

DB_NAME: Debe coincidir exactamente con el nombre de la base de datos que viste en cPanel.
DB_USER: Debe ser el usuario que tiene acceso a esa base.
DB_PASSWORD: La contraseña de ese usuario. Si la cambiaste en cPanel, actualízala aquí.
DB_HOST: Normalmente es localhost, pero a veces tu hosting usa un servidor diferente (por ejemplo, mysql.tudominio.com). Pregunta a tu soporte o revisa la documentación de tu hosting.

[TIP] Si no recuerdas la contraseña del usuario, puedes cambiarla desde cPanel en "Usuarios MySQL". Luego, actualiza wp-config.php con la nueva.

Guarda los cambios

Después de editar, haz clic en "Guardar cambios" y luego cierra el editor. Vuelve a cargar tu web para ver si el error desaparece.

Paso 3: Repara la base de datos desde cPanel

A veces la base de datos se corrompe ligeramente (por ejemplo, tras una actualización fallida). cPanel tiene una herramienta para repararla.

Usa phpMyAdmin para reparar

En cPanel, ve a "phpMyAdmin" (dentro de "Bases de Datos").
Selecciona tu base de datos en la columna de la izquierda.
Verás una lista de tablas. Marca la casilla de arriba para seleccionarlas todas (o haz Ctrl + clic en cada una).
En el menú desplegable de abajo (junto a "Con seleccionados:"), elige "Reparar tabla".
phpMyAdmin ejecutará una reparación. Si todo va bien, verás un mensaje de éxito.

[INFO] Si la reparación falla, puede que la base de datos esté más dañada. En ese caso, necesitarías restaurar una copia de seguridad. Pero primero prueba este paso.

Paso 4: Verifica el estado del servidor MySQL

A veces el problema no es tuyo, sino del servidor. El servicio MySQL puede estar caído o sobrecargado.

Desde cPanel, comprueba el estado

Ve a "Estado del Servidor" (a veces dentro de "Información del Servidor" o similar). No todos los cPanel lo tienen visible.
Busca la línea de MySQL (o MariaDB). Debería decir "En ejecución" o "Running".
Si aparece "Detenido" o "Stopped", contacta a tu proveedor de hosting inmediatamente. No puedes reiniciarlo desde cPanel (a menos que tengas acceso root, lo cual es raro).

[WARNING] Si el servidor MySQL está caído, no pierdas tiempo con configuraciones. Abre un ticket de soporte con tu hosting.

Paso 5: Prueba con un plugin o tema por defecto (si puedes acceder al wp-admin)

A veces el error aparece solo en el frontend, pero puedes acceder al escritorio de WordPress. Si es tu caso, podemos descartar conflictos.

Si puedes entrar a /wp-admin

Ve a Plugins y desactiva todos. Si no puedes, renombra la carpeta wp-content/plugins desde el Administrador de Archivos de cPanel (cámbiale el nombre a plugins_old).
Si el error desaparece, reactiva los plugins de uno en uno para encontrar el culpable.
También puedes cambiar temporalmente a un tema por defecto (Twenty Twenty-Four, por ejemplo) desde Apariencia > Temas.

[TIP] Si no puedes acceder ni siquiera al wp-admin, salta este paso y ve directo a la restauración de copia de seguridad.

Paso 6: Restaura una copia de seguridad (si todo lo anterior falla)

Si después de todos los pasos el error persiste, lo más seguro es restaurar una copia de seguridad reciente. Esto te devolverá la base de datos y los archivos a un estado funcional.

Restaurar desde cPanel

Ve a "Copias de Seguridad" (o "Backups") en cPanel.
Descarga una copia reciente de la base de datos (archivo .sql) y de los archivos (archivo .zip o .tar.gz).
Si tienes una copia completa, puedes restaurar usando "Restaurar una copia de seguridad de MySQL" y "Restaurar archivos".
Si no tienes copia, contacta a tu hosting. Algunos proveedores guardan backups automáticos.

[WARNING] Restaurar una copia de seguridad sobrescribirá los datos actuales. Asegúrate de que sea una copia anterior al error.

Preguntas frecuentes (FAQ)

¿Qué hago si el error dice "Error establishing a database connection" y no puedo acceder a cPanel?

Si no tienes acceso a cPanel, contacta a tu proveedor de hosting. Ellos pueden verificar el estado del servidor y ayudarte a restaurar el acceso. También puedes intentar editar el archivo wp-config.php mediante FTP (con un cliente como FileZilla) si tienes las credenciales.

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

No. Reparar tablas solo corrige errores internos, no borra información. Es seguro.

¿Por qué aparece este error después de migrar mi web?

Es muy común. Al migrar, los datos de conexión (nombre de base, usuario, contraseña) cambian. Debes actualizar wp-config.php con los nuevos datos que te proporcione tu nuevo hosting.

¿El error puede deberse a un ataque?

Sí, aunque es menos frecuente. Un atacante podría modificar el archivo wp-config.php o dañar la base de datos. Si sospechas, cambia todas las contraseñas (cPanel, WordPress, base de datos) y escanea tu web con un plugin de seguridad (como Wordfence) una vez que recuperes el acceso.

¿Qué es Syspanel y cómo se relaciona con esto?

Si tu hosting usa Syspanel (antes conocido como HestiaCP), el proceso es similar, pero el acceso al panel se hace por el puerto 2106 (por ejemplo, https://tudominio.com:2106). Dentro de Syspanel, busca la sección "Base de datos" para administrar usuarios y bases, y también hay un administrador de archivos para editar wp-config.php. El resto de pasos son idénticos.

Resumen final

El error conexión base datos WordPress suele ser sencillo de arreglar si sigues estos pasos en orden:

Verifica que la base y el usuario existan en cPanel.
Revisa y corrige el archivo wp-config.php.
Repara la base de datos con phpMyAdmin.
Comprueba que MySQL esté funcionando.
Desactiva plugins/tema (si puedes).
Restaura una copia de seguridad como último recurso.

Recuerda que la paciencia es clave. No te desesperes y, si todo falla, el soporte de tu hosting está para ayudarte. ¡Buena suerte y que tu web vuelva a volar pronto!