Arreglar error de conexión a base de datos WordPress | cPanel

¿Te has encontrado con el temido mensaje "Error al establecer una conexión a la base de datos" en tu web WordPress? No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene solución. En esta guía extensa y paso a paso, te explicaré cómo solucionar el error conexión base datos WordPress utilizando las herramientas que tienes en cPanel. Incluso si no eres un experto técnico, podrás seguir estos pasos y recuperar tu sitio en pocos minutos.

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

El mensaje "Error al establecer una conexión a la base de datos" (o en inglés "Error establishing a database connection") indica que WordPress no puede comunicarse con el servidor donde está almacenada tu base de datos. Sin esta conexión, tu web no puede mostrar ningún contenido.

Las causas más frecuentes son:

Datos de acceso incorrectos en el archivo wp-config.php.
La base de datos o el usuario han sido eliminados o modificados accidentalmente.
El servidor de la base de datos (MySQL) está caído o sobrecargado.
Problemas de permisos en la base de datos.
Un plugin o tema defectuoso que corrompió la conexión.

[INFO] Este error no significa que hayas perdido tu web. Tus archivos y contenido siguen intactos, solo hay que restablecer el puente de comunicación.

Paso 1: Verifica el estado de tu servidor MySQL desde cPanel

Antes de tocar nada, asegúrate de que el problema no sea del servidor. Si el servicio MySQL está detenido, ningún sitio funcionará.

Inicia sesión en cPanel (normalmente accedes a través de tudominio.com/cpanel o tudominio.com:2083).
Busca la sección "Estado del servidor" o "Server Status". En algunos temas de cPanel puede llamarse "Estadísticas" o "Información del servidor".
Revisa si el servicio MySQL (o MariaDB) aparece con un círculo verde y la palabra "Running" (Ejecutándose). Si ves un círculo rojo o amarillo, el servicio está caído.

¿Qué hacer si MySQL está detenido?

Si tienes acceso a WHM (solo si eres administrador del servidor), puedes reiniciar el servicio desde allí.
Si eres usuario de un hosting compartido, contacta al soporte técnico de tu proveedor inmediatamente. Diles que el servicio MySQL no está activo.

[WARNING] Si el servidor está bien (verde), pasa al siguiente paso. No modifiques nada aún.

Paso 2: Revisa los datos de conexión en `wp-config.php`

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene el nombre de la base de datos, usuario, contraseña y servidor. Un error tipográfico o un cambio accidental aquí provoca el WordPress error base datos.

Cómo acceder y editar el archivo desde cPanel

En cPanel, busca la sección "Archivos" y haz clic en "Administrador de archivos" (File Manager).
Se abrirá una ventana. Asegúrate de estar en la raíz de tu sitio (normalmente public_html o una carpeta con el nombre de tu dominio).
Busca el archivo wp-config.php (no lo confundas con wp-config-sample.php).
Haz clic derecho sobre él y selecciona "Editar" (o "Code Editor"). Si te pide confirmación, acéptala.

¿Qué debes buscar?

Dentro del archivo, localiza estas líneas (aproximadamente en las primeras 30 líneas):

define('DB_NAME', 'nombre_de_tu_base');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_secreta');
define('DB_HOST', 'localhost');

DB_NAME: Debe coincidir exactamente con el nombre de tu base de datos en cPanel.
DB_USER: El usuario asociado a esa base de datos.
DB_PASSWORD: La contraseña de ese usuario. ¡Cuidado con caracteres especiales!
DB_HOST: Normalmente es localhost, pero algunos hostings usan direcciones como mysql.tudominio.com o 127.0.0.1. Si no estás seguro, déjalo como localhost.

[TIP] Si ves que DB_HOST tiene algo como localhost:/tmp/mysql.sock, no lo cambies a menos que sepas lo que haces. Es una configuración de socket.

¿Y si no encuentras el archivo `wp-config.php`?

Si no ves el archivo, puede estar oculto. En el Administrador de archivos, busca un botón o checkbox que diga "Mostrar archivos ocultos" (Show Hidden Files). Actívalo y vuelve a cargar la carpeta.

Paso 3: Verifica que la base de datos y el usuario existan en cPanel

A veces, al migrar un sitio o por error humano, la base de datos o el usuario son eliminados. Para comprobarlo:

En cPanel, ve a la sección "Bases de datos" y haz clic en "Bases de datos MySQL" (o "MySQL Databases").
Verás una lista de todas las bases de datos creadas. Busca el nombre que aparece en DB_NAME de tu wp-config.php.
Si no aparece, tendrás que crearla de nuevo. Pero antes, no borres nada del archivo wp-config.php. Simplemente crea una nueva base de datos con el mismo nombre exacto (es posible que el hosting no te deje si ya existió; en ese caso, crea una con un nombre ligeramente diferente y luego actualiza DB_NAME en wp-config.php).
Luego, en la misma página, desplázate hacia abajo hasta "Usuarios actuales". Verifica que el usuario de DB_USER exista.
Si el usuario no existe, créalo (con una contraseña segura) y luego asigna el usuario a la base de datos marcando todos los privilegios (SELECT, INSERT, UPDATE, DELETE, etc.). Haz clic en "Agregar".

[WARNING] Si creaste una nueva base de datos o usuario, debes actualizar wp-config.php con los nuevos nombres y contraseña. No olvides guardar los cambios.

Paso 4: Restablece la contraseña del usuario de la base de datos

A veces la contraseña del usuario se corrompe o se cambia sin querer. Restablecerla es fácil:

En cPanel, ve a "Bases de datos MySQL".
En la sección "Usuarios actuales", busca el usuario que usa WordPress.
Haz clic en "Cambiar contraseña" (o "Change Password").
Genera una contraseña segura (puedes usar el generador de cPanel) y cópiala.
Importante: Ahora ve a tu archivo wp-config.php y reemplaza la línea DB_PASSWORD con la nueva contraseña.
Guarda los cambios.

Paso 5: Revisa los privilegios del usuario

A veces el usuario está asociado a la base de datos pero sin permisos suficientes. Para asegurarte:

En la misma página de "Bases de datos MySQL", busca la sección "Agregar usuario a la base de datos" (si ya está agregado, verás una tabla con los usuarios asignados).
Si el usuario aparece, haz clic en "Administrar privilegios" (o "Manage Privileges").
Marca "Todos los privilegios" (SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, etc.). No te preocupes, es seguro para WordPress.
Haz clic en "Hacer cambios".

Paso 6: Prueba con el servidor de base de datos alternativo

Si todo lo anterior falla, el problema podría ser que el servidor localhost no funcione correctamente. Algunos hostings usan un servidor dedicado para MySQL.

En wp-config.php, cambia DB_HOST de 'localhost' a '127.0.0.1' (es la dirección IP de localhost). Guarda y prueba.
Si eso no funciona, consulta con tu proveedor de hosting cuál es el host de MySQL correcto. A veces es algo como mysql.tudominio.com o localhost:/tmp/mysql.sock.
También puedes probar con 'localhost' pero añadiendo el puerto: 'localhost:3306' (el puerto por defecto de MySQL).

[INFO] Si usas Syspanel (anteriormente HestiaCP), recuerda que el acceso a cPanel se hace por el puerto 2106. Pero para la conexión a la base de datos, el host suele ser localhost o la IP del servidor. No confundas los puertos.

Paso 7: Repara la base de datos desde phpMyAdmin

Si la base de datos está corrupta (por ejemplo, tras una migración fallida), WordPress no podrá conectarse. Puedes repararla fácilmente:

En cPanel, busca "phpMyAdmin" (dentro de la sección "Bases de datos").
Selecciona tu base de datos en el panel izquierdo.
En la parte inferior, verás un enlace que dice "Marcar todas" (Check All). Selecciona todas las tablas.
En el menú desplegable "Con seleccionados:", elige "Reparar tabla" (Repair table).
phpMyAdmin ejecutará una reparación. Si todo sale bien, verás mensajes verdes.

[TIP] Si no ves la opción de reparar, es porque tu hosting usa el motor de almacenamiento InnoDB, que no se puede reparar desde phpMyAdmin. En ese caso, contacta a soporte.

Paso 8: Desactiva plugins y temas desde la base de datos (último recurso)

A veces un plugin o tema defectuoso corrompe la conexión. Si no puedes acceder al panel de administración de WordPress, puedes desactivarlos manualmente desde la base de datos.

Entra a phpMyAdmin y selecciona tu base de datos.
Busca la tabla wp_options (el prefijo wp_ puede ser diferente si lo cambiaste).
Localiza la fila donde option_name es active_plugins.
Haz clic en "Editar" (lápiz) y borra todo el contenido del campo option_value. Déjalo vacío.
Guarda los cambios. Esto desactivará todos los plugins.
Para desactivar el tema activo, busca en la misma tabla la fila con option_name = template y stylesheet. Cambia sus valores a un tema por defecto como twentytwentyfour (o cualquier tema que esté instalado).

Después de esto, intenta acceder a tu web. Si funciona, el problema era un plugin o tema. Reactívalos uno por uno desde el panel de administración para identificar al culpable.

Preguntas Frecuentes (FAQ)

1. ¿Por qué veo el error "Error de conexión a la base de datos" después de mover mi web a un nuevo hosting?

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

2. ¿Qué hago si mi cPanel no tiene la opción "Bases de datos MySQL"?

Algunos planes de hosting muy básicos no incluyen MySQL. Si ese es tu caso, deberás contratar un plan que lo incluya o usar un servicio externo como Amazon RDS. Pero lo más probable es que sí lo tengas, busca en la sección "Bases de datos".

3. ¿El error puede deberse a un ataque de hackers?

Sí. A veces los hackers modifican el archivo wp-config.php para redirigir la base de datos a un servidor malicioso. Si sospechas de un ataque, restaura una copia de seguridad limpia del archivo y cambia todas las contraseñas.

4. ¿Cómo sé si mi base de datos está caída?

Además de revisar el estado del servidor en cPanel, puedes crear un archivo PHP simple en tu servidor con el siguiente contenido:

<?php
$conexion = mysqli_connect('localhost', 'usuario', 'contraseña', 'base_de_datos');
if (!$conexion) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo 'Conectado correctamente';
?>

Si al visitar ese archivo ves el mensaje "Conectado correctamente", el problema está en WordPress, no en la base de datos.

5. Si uso Syspanel (HestiaCP), ¿cómo accedo a cPanel?

Syspanel (HestiaCP) no es cPanel, es un panel diferente. Para acceder a sus herramientas de base de datos, usa la URL https://tudominio.com:2106 e inicia sesión con tus credenciales. Allí encontrarás opciones similares para gestionar MySQL.

Conclusión

El error conexión base datos WordPress puede parecer grave, pero siguiendo estos pasos metódicamente lo resolverás en la mayoría de los casos. Recuerda siempre:

Verificar el estado del servidor MySQL.
Revisar y corregir los datos en wp-config.php.
Asegurarte de que la base de datos y el usuario existen y tienen privilegios.
Probar con diferentes valores de DB_HOST.
Reparar la base de datos si es necesario.

Si después de todo esto el error persiste, contacta a tu proveedor de hosting. Ellos pueden revisar los logs del servidor y detectar problemas más profundos, como un límite de conexiones alcanzado o un problema de firewall.

[TIP] Para evitar este error en el futuro, realiza copias de seguridad periódicas de tu base de datos y archivos. Muchos hostings ofrecen copias automáticas desde cPanel. ¡No las descuides!

Espero que esta guía te haya sido de gran ayuda. Recuerda que la paciencia es clave: tómate tu tiempo para seguir cada paso y no dudes en consultar a tu hosting si algo no queda claro. ¡Tu web volverá a estar en línea pronto!