Error de conexión a base de datos WordPress en cPanel | Arreglar

¡Hola! Soy tu técnico de soporte amigable. Entiendo lo frustrante que es ver el mensaje de "Error al establecer una conexión a la base de datos" en tu sitio WordPress. Es uno de los errores más comunes, pero también uno de los más fáciles de solucionar si sabes dónde mirar. En esta guía te voy a explicar paso a paso cómo resolver este problema, especialmente si gestionas tu hosting desde cPanel. Usaremos palabras clave como error conexión base datos WordPress, cPanel WordPress database error, solucionar error base datos y WordPress no conecta cPanel para que encuentres esto fácilmente.

Vamos a desglosar las causas más habituales y las soluciones prácticas. No necesitas ser un experto técnico, solo sigue las instrucciones al pie de la letra y, si algo no cuadra, no dudes en consultar con tu proveedor de hosting.

¿Por qué aparece este error?

El error de conexión a la base de datos en WordPress suele deberse a que el archivo de configuración wp-config.php tiene datos incorrectos, o a que la base de datos misma tiene problemas (como credenciales cambiadas, nombre incorrecto o que el servicio de MySQL esté caído). También puede ocurrir si el servidor tiene algún bloqueo temporal.

Antes de empezar, respira hondo. No has perdido tu sitio. Todo está ahí, solo necesitas reconectar los cables correctos.

Paso 1: Verifica el estado de tu base de datos en cPanel

Lo primero es asegurarte de que la base de datos existe y está activa. Para ello:

Inicia sesión en cPanel (normalmente en tudominio.com/cpanel o tudominio.com:2083).
Busca la sección "Bases de datos" y haz clic en "Bases de datos MySQL".
Verás una lista de bases de datos. Busca la que usa tu WordPress. Si no ves ninguna, es posible que la hayan eliminado accidentalmente. Si está, anota el nombre exacto (suele ser algo como usuario_wordpress).
También revisa en "Usuarios MySQL" que el usuario asociado a esa base de datos exista. Si no, tendrás que crearlo y vincularlo.

[INFO] Si tu hosting usa Syspanel (antes conocido como HestiaCP), el acceso es por el puerto 2106 (ejemplo: tudominio.com:2106). Allí busca la sección de bases de datos.

Paso 2: Comprueba las credenciales en tu archivo wp-config.php

El archivo wp-config.php es el corazón de la conexión. Si los datos que contiene no coinciden con los de cPanel, WordPress no podrá conectar.

Cómo localizar y editar wp-config.php

Desde cPanel, ve a "Administrador de archivos" (File Manager).
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o una subcarpeta como blog).
Busca el archivo wp-config.php. Si no lo ves, asegúrate de tener activada la opción "Mostrar archivos ocultos" (dotfiles).
Haz clic derecho sobre el archivo y selecciona "Editar".

Datos que debes verificar

Dentro del archivo, busca estas líneas:

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 la base de datos que viste en cPanel (incluyendo el prefijo de usuario, por ejemplo midominio_wp).
DB_USER: El nombre del usuario MySQL que tiene permisos sobre esa base de datos.
DB_PASSWORD: La contraseña de ese usuario. Si la olvidaste, en cPanel puedes cambiarla desde "Usuarios MySQL".
DB_HOST: Normalmente es localhost, pero algunos proveedores usan algo como mysql.tudominio.com. Si tu hosting usa cPanel, lo más seguro es que sea localhost.

[WARNING] Si cambias la contraseña en cPanel, debes actualizarla también en wp-config.php. Si no, el error persistirá.

Paso 3: Revisa el prefijo de la base de datos y los permisos del usuario

A veces, aunque el nombre y usuario sean correctos, el usuario no tiene todos los permisos necesarios sobre la base de datos.

En cPanel, ve a "Bases de datos MySQL".
En la sección "Añadir usuario a la base de datos", selecciona el usuario y la base de datos.
En la pantalla de permisos, marca "Todos los privilegios" (o al menos SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP).
Haz clic en "Realizar cambios".

[TIP] Si después de esto sigue fallando, elimina al usuario de la base de datos y vuelve a añadirlo con todos los permisos.

Paso 4: Verifica que el servicio de MySQL esté funcionando

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

Desde cPanel, busca la sección "Estado del servidor" o "Información del servidor".
Busca MySQL en la lista. Debería aparecer como "En ejecución" o "Running".
Si ves que está detenido, contacta a tu proveedor de hosting. No puedes reiniciarlo desde cPanel (a menos que tengas acceso root, que normalmente no).

[WARNING] Si usas Syspanel (HestiaCP), el estado del servicio lo ves desde la terminal o preguntando al soporte. En el panel web no suele haber indicador.

Paso 5: Prueba con un archivo de prueba de conexión

Para descartar que sea un problema de WordPress en sí, puedes crear un pequeño archivo PHP que pruebe la conexión directa a la base de datos.

Desde el Administrador de archivos, crea un nuevo archivo en la carpeta raíz de WordPress llamado testdb.php.
Pega este código (reemplaza los datos con los tuyos):

<?php
$link = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_datos');
if (!$link) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo '¡Conexión exitosa!';
mysqli_close($link);
?>

Guarda el archivo y luego accede a tudominio.com/testdb.php.
Si ves "¡Conexión exitosa!", el problema está en la configuración de WordPress, no en la base de datos. Si ves un error, entonces la base de datos o las credenciales están mal.

[INFO] No olvides borrar este archivo después de la prueba por seguridad.

Paso 6: Revisa el cortafuegos o bloqueos de IP

Algunos hosts tienen reglas de cortafuegos que bloquean conexiones a MySQL desde ciertas IPs o si hay muchos intentos fallidos.

Si has cambiado la contraseña varias veces o has tenido errores seguidos, es posible que tu IP esté bloqueada temporalmente.
Contacta al soporte de tu hosting y pídeles que verifiquen si hay algún bloqueo en el firewall para conexiones MySQL.

Paso 7: Restaura una copia de seguridad del archivo wp-config.php

Si modificaste el archivo y no estás seguro de los valores originales, puedes restaurar una copia de seguridad. Muchos proveedores de hosting hacen copias automáticas.

En cPanel, busca "Copias de seguridad" o "Backup".
Descarga la copia más reciente de tu sitio.
Extrae el archivo wp-config.php original y súbelo de nuevo al servidor, reemplazando el actual.

[WARNING] Si no tienes copia, siempre puedes crear un nuevo archivo wp-config.php desde cero. WordPress tiene un asistente en tudominio.com/wp-admin/setup-config.php si borras el archivo actual.

Preguntas frecuentes (FAQ)

¿Qué hago si no encuentro el archivo wp-config.php?

Puede que esté oculto. En el Administrador de archivos de cPanel, haz clic en "Configuración" y marca "Mostrar archivos ocultos (dotfiles)". También puedes buscarlo con el buscador de archivos.

¿Por qué aparece el error después de migrar mi sitio?

Al migrar, las credenciales de la base de datos suelen cambiar. Asegúrate de que el nuevo hosting tenga los datos correctos en wp-config.php. También verifica que la base de datos esté importada correctamente.

¿Puedo usar otro gestor de bases de datos como phpMyAdmin?

Sí, desde cPanel puedes acceder a phpMyAdmin para verificar que las tablas existan. Si ves el mensaje "Tabla no existe", puede que la base de datos esté vacía o corrupta. En ese caso, necesitas importar una copia de seguridad.

¿Qué significa "Error establishing a database connection" en blanco?

A veces el error aparece sin más detalles. Esto suele indicar que el servidor MySQL está caído o que el archivo wp-config.php tiene un error de sintaxis (como una comilla mal puesta).

¿El error puede deberse a un plugin?

Raramente, pero algunos plugins maliciosos o con errores pueden modificar el archivo wp-config.php. Si todo lo demás falla, desactiva todos los plugins renombrando la carpeta wp-content/plugins a plugins_old desde el Administrador de archivos.

Resumen rápido de soluciones

Verifica la existencia de la base de datos en cPanel.
Comprueba las credenciales en wp-config.php (nombre, usuario, contraseña, host).
Asegura que el usuario tenga todos los permisos sobre la base de datos.
Confirma que MySQL esté funcionando en el servidor.
Prueba con un script de conexión para aislar el problema.
Revisa bloqueos de IP o cortafuegos con tu soporte.
Restaura una copia de seguridad si modificaste algo sin querer.

[TIP] Si después de todo esto sigues sin conectar, contacta al soporte de tu hosting. Diles que tienes un cPanel WordPress database error y que ya verificaste credenciales y permisos. Ellos pueden revisar los logs del servidor para encontrar la causa exacta.

Espero que esta guía te haya sido de gran ayuda. Recuerda que, aunque este error puede ser alarmante, casi siempre tiene solución. Si tienes más dudas, no dudes en preguntar. ¡Buena suerte con tu WordPress!