Error al establecer una conexión con la base de datos: solución

Qué significa

WordPress guarda todo su contenido en una base de datos MySQL. Si no logra conectarse a ella, no puede mostrar nada y aparece el mensaje Error al establecer una conexión con la base de datos.

Causas habituales

Paso 1: comprueba si también falla el panel

Abre tu dominio seguido de /wp-admin.

• Si muestra el mismo error, el problema es de conexión.
• Si indica que una o más tablas no están disponibles y que la base necesita reparación, salta al paso 4.

Paso 2: revisa wp-config.php

Con el Administrador de archivos de cPanel abre wp-config.php en la raíz del sitio y localiza cuatro valores:

• DB_NAME: nombre de la base.
• DB_USER: usuario.
• DB_PASSWORD: contraseña.
• DB_HOST: normalmente localhost.

Compáralos con lo que aparece en cPanel, Bases de datos MySQL. Recuerda que los nombres llevan el prefijo de tu cuenta.

Paso 3: verifica usuario y permisos

En la misma pantalla de cPanel:

1. Confirma que la base existe.
2. Confirma que el usuario existe.
3. En la sección de usuarios agregados a la base, comprueba que ese usuario esté asignado con todos los privilegios.
4. Si dudas de la contraseña, cámbiala ahí y escribe la nueva en wp-config.php.

Paso 4: repara las tablas

Dos opciones:

• En cPanel, Bases de datos MySQL, usa Reparar base de datos.
• En phpMyAdmin, selecciona todas las tablas y elige Reparar tabla.

WordPress también tiene una herramienta propia que se habilita añadiendo una constante de reparación en wp-config.php; retírala al terminar, porque cualquiera podría usarla.

Paso 5: descarta la saturación

Si el error aparece y desaparece, el servidor de base de datos puede estar alcanzando el límite de conexiones.

• Revisa el uso de recursos en cPanel.
• Activa la caché de página para reducir consultas.
• Identifica plugins que generen muchas consultas.
• Consulta al soporte si el servicio MySQL tuvo una incidencia.

Paso 6: revisa el espacio

Con el disco al 100 %, MySQL no puede escribir y falla. Libera espacio borrando respaldos antiguos y correos pesados.

Tras una migración

Es el escenario más común: la base se creó con otro nombre o usuario en el nuevo hosting. Actualiza los cuatro valores y el error desaparece.

Cómo prevenirlo

• Mantén respaldos recientes de la base.
• No dejes que el disco se llene.
• Usa caché y limpia la base periódicamente.
• Elige un hosting con recursos acordes a tu tráfico.

Conclusión

En la mayoría de casos se resuelve en cinco minutos revisando wp-config.php. Si no lo consigues, escríbenos por WhatsApp y lo revisamos contigo.