Error de conexión con la base de datos en WordPress: causas y solución

Cuando WordPress muestra el mensaje "Error al establecer una conexión con la base de datos", significa que el código de WordPress no puede comunicarse con MySQL, el motor de base de datos donde se almacena todo el contenido de tu sitio.

Este error es uno de los más comunes en WordPress y también uno de los más alarmantes visualmente: el sitio muestra una página en blanco con ese mensaje y nada más. Sin embargo, en la mayoría de los casos tiene solución en menos de 15 minutos.

Diferencia clave: si el error aparece en el frontend pero puedes acceder a wp-admin con normalidad, el problema suele ser una sobrecarga temporal. Si el error aparece tanto en el frontend como en wp-admin, el problema es más serio.

Antes de entrar en pánico: este error no significa que hayas perdido tus datos. La base de datos sigue ahí. Lo que falla es la conexión hacia ella.

Causa 1: Credenciales incorrectas en wp-config.php

La causa más frecuente, especialmente después de una migración o un cambio de hosting, son las credenciales de base de datos incorrectas en el archivo wp-config.php.

Cómo verificar y corregir DB_NAME, DB_USER, DB_PASSWORD y DB_HOST

El archivo wp-config.php en la raíz de tu instalación de WordPress contiene cuatro constantes que definen la conexión a la base de datos:

define( 'DB_NAME', 'nombre_de_tu_base_de_datos' );
define( 'DB_USER', 'usuario_de_base_de_datos' );
define( 'DB_PASSWORD', 'contraseña' );
define( 'DB_HOST', 'localhost' );

Para verificar que los datos son correctos:

1. Accede a cPanel > MySQL Databases
2. En "Bases de datos actuales" verás el nombre exacto de la base de datos
3. En "Usuarios de MySQL actuales" verás los usuarios existentes
4. En "Usuarios y sus bases de datos" verás qué usuario está asignado a qué base de datos

El nombre que aparece en cPanel incluye un prefijo de tu cuenta. Ese es el valor exacto que debes poner en DB_NAME.

Para editar wp-config.php: desde cPanel accede al Administrador de archivos > public_html > wp-config.php, haz clic derecho y selecciona "Editar".

Causa 2: El servicio MySQL está caído en el hosting

A veces el problema no es tu sitio sino el servidor. Si el servicio MySQL del hosting se cayó por mantenimiento, alta carga o un fallo técnico, ningún sitio en ese servidor podrá conectarse a la base de datos.

Para confirmar si el problema es del servidor, intenta acceder a phpMyAdmin desde cPanel. Si phpMyAdmin tampoco carga, el problema es del servidor, no de tu WordPress.

Si el problema es del servidor, no hay nada que puedas hacer desde tu WordPress — la solución está del lado del hosting. En Elevocloud, el equipo de soporte monitorea activamente el estado de MySQL.

Causa 3: Base de datos corrupta o tablas dañadas

En algunos casos, las tablas de la base de datos de WordPress pueden reestructurarse por un cierre inesperado del servidor, un plugin mal codificado o una interrupción durante una actualización.

Cómo reparar tablas desde phpMyAdmin

Método 1: Reparar desde phpMyAdmin

1. Accede a cPanel > phpMyAdmin
2. Selecciona la base de datos de tu WordPress en el panel izquierdo
3. Marca todas las tablas (o selecciona solo las que quieras reparar)
4. En el menú desplegable, elige "Reparar tabla"

Método 2: Modo de reparación de WordPress

WordPress tiene un modo de reparación incorporado que puedes activar añadiendo esta línea en wp-config.php:

define( 'WP_ALLOW_REPAIR', true );

Luego visita: https://tudominio.com/wp-admin/maint/repair.php

⚠️ Advertencia de seguridad: elimina la línea WP_ALLOW_REPAIR de wp-config.php inmediatamente después de usar la herramienta de reparación. Esta página no requiere contraseña y cualquiera con la URL podría acceder a ella si la constant permanece activada.

Causa 4: Límite de conexiones simultáneas alcanzado

En planes de hosting compartido, existe un límite en el número de conexiones simultáneas a MySQL. Si tu sitio recibe un pico de tráfico inesperado, puede alcanzar ese límite.

Cómo identificarlo: el error aparece intermitentemente, no de forma constante.

Soluciones:

• Instalar un plugin de caché (como LiteSpeed Cache) para reducir la cantidad de consultas a MySQL
• Optimizar las queries del sitio con el plugin Query Monitor
• Considerar un plan superior si el tráfico es alto de forma regular

Causa 5: Plugin o tema generando queries excesivos

Algunos plugins pueden generar un número desproporcionado de consultas a la base de datos. Para diagnosticarlo:

1. Accede a tu sitio en modo seguro desactivando todos los plugins desde phpMyAdmin (tabla wp_options, opción active_plugins)
2. Si el error desaparece, activa los plugins de uno en uno hasta identificar el culpable

Si nada funciona: cuándo contactar al soporte de hosting

Si has revisado las credenciales, phpMyAdmin carga sin problemas, las tablas están intactas y el error persiste, es momento de contactar al soporte de tu hosting.

Qué información dar al soporte: el mensaje de error exacto, si el error es constante o intermitente, cuándo comenzó el problema, y si hiciste cambios recientes.

Preguntas frecuentes

¿Perdí mis datos por este error?

No. El error de conexión con la base de datos no elimina ni corrompe tus datos. Los datos siguen almacenados en el servidor.

¿Puedo editar wp-config.php desde FTP si no tengo acceso a cPanel?

Sí. Conéctate con cualquier cliente FTP (FileZilla) usando las credenciales FTP de tu hosting y navega hasta el archivo wp-config.php en la carpeta raíz.

¿Este error afecta a todos los visitantes o solo a mí?

Afecta a todos los visitantes. No es un problema de caché local ni del navegador.

¿Problemas recurrentes con la base de datos en tu hosting actual? En Elevocloud monitoreamos MySQL las 24 horas y nuestro soporte técnico está disponible para ayudarte. Conoce nuestros planes de hosting WordPress con soporte incluido.