Error de conexión a base de datos WordPress: cómo solucionarlo

Entras a tu sitio WordPress y en lugar de tu página aparece un mensaje frío: “Error establishing a database connection” (Error al establecer conexión con la base de datos). Tu sitio está caído, tus visitantes no pueden acceder y el pánico empieza a crecer.

Respira. Este es uno de los errores más comunes de WordPress y casi siempre tiene solución rápida. En esta guía te llevamos paso a paso por las 5 causas principales y cómo arreglar cada una, de lo más fácil a lo más técnico.

¿Qué significa este error?

Cuando WordPress no puede conectarse a la base de datos MySQL donde guarda posts, páginas, usuarios y configuraciones, muestra este mensaje de error genérico. Las causas típicas son:

1. Credenciales de base de datos incorrectas en wp-config.php.
2. Servidor de base de datos caído.
3. Base de datos corrupta.
4. Recursos de hosting agotados.
5. Archivo wp-config.php dañado o mal configurado.

Solución 1: Recarga la página y espera

Puede sonar trivial, pero el 30% de los casos se resuelven solos. El servidor MySQL puede estar reiniciándose o saturado temporalmente.

Pasos:

1. Cierra la pestaña.
2. Espera 2-3 minutos.
3. Vuelve a entrar usando Ctrl+F5 (recarga forzada sin caché).

Si el error persiste, pasa a la solución 2.

Solución 2: Verifica las credenciales en wp-config.php

El 60% de las veces, el error viene de credenciales incorrectas en wp-config.php. Esto ocurre típicamente tras migrar a otro hosting, cambiar la contraseña de la BD, o por una modificación accidental.

Paso 1: Accede a los archivos de tu sitio

Conéctate por FTP (FileZilla, Cyberduck) o desde el administrador de archivos de tu panel (cPanel → File Manager).

Paso 2: Abre wp-config.php

Está en la raíz de tu WordPress. 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' );

Paso 3: Compara con las credenciales reales

Ve a tu panel de hosting → Bases de datos MySQL. Verifica que:

• El nombre de la BD coincide exactamente.
• El usuario asociado coincide.
• La contraseña es la correcta (si dudas, crea una nueva y actualiza).
• El host es el correcto (normalmente localhost, pero algunos proveedores usan mysql.proveedor.com o una IP).

Paso 4: Guarda y prueba

Si corriges algo, guarda el archivo y recarga tu sitio.

Solución 3: Repara la base de datos WordPress

Si la BD está parcialmente corrupta, WordPress incluye una herramienta de reparación nativa.

Paso 1: Activa el modo reparación

Añade esta línea a wp-config.php (antes de la línea /* That's all, stop editing! */):

define( 'WP_ALLOW_REPAIR', true );

Paso 2: Ejecuta la reparación

Visita en el navegador:

https://tusitio.com/wp-admin/maint/repair.php

Verás dos opciones:

• Repair Database: solo reparar.
• Repair and Optimize Database: reparar y optimizar (recomendado).

Pulsa una de las dos y espera. WordPress recorrerá todas las tablas reparando las dañadas.

Paso 3: Elimina el permiso (importante)

Cuando termine, ELIMINA la línea que añadiste en wp-config.php. Si la dejas, cualquiera puede acceder a esa URL y reparar tu base de datos.

Solución 4: Verifica si el servidor MySQL está caído

A veces el problema no está en tu sitio, sino en el servidor MySQL del hosting.

Pasos de diagnóstico

1. Verifica otros sitios en el mismo hosting. Si tienes más de un sitio y todos fallan, el servidor MySQL está caído.
2. Entra a phpMyAdmin. Si no carga o te da error de conexión, el MySQL está caído.
3. Contacta al soporte del hosting. Si tu hosting tiene problemas de servidor, solo el proveedor puede arreglarlo.

Hosts en VPS

Si tienes un VPS Cloud, puedes verificar directamente desde la terminal:

sudo systemctl status mysql
# o
sudo systemctl status mariadb

Si dice “inactive (dead)”, reinicia:

sudo systemctl restart mysql

Solución 5: Recursos del hosting agotados (tráfico alto)

Cuando recibes picos de tráfico o tu plan de hosting se queda corto, el servidor MySQL puede rechazar nuevas conexiones y mostrar el error.

Señales de que son recursos

• El error aparece en horas pico y desaparece en horas valle.
• Tu panel de hosting muestra CPU/RAM al 100%.
• Tu proveedor te ha enviado alertas por uso excesivo.
• El sitio carga intermitentemente.

Qué hacer

1. Limpia caché (si usas LiteSpeed Cache, WP Rocket, W3TC).
2. Desactiva plugins pesados temporalmente para aliviar la carga.
3. Contacta al soporte para aumentar el límite de conexiones MySQL.
4. Considera upgrade a un plan con más recursos, como Hosting Empresarial o VPS Cloud.

Si tu tienda WooCommerce recibe mucho tráfico y este error aparece seguido, revisa nuestra guía de hosting para WooCommerce.

Solución avanzada: crear un nuevo usuario MySQL

Si sospechas que el usuario de base de datos está corrupto o tiene permisos rotos, crea uno nuevo.

Paso 1: Desde el panel de hosting

1. Ve a MySQL Databases en cPanel/Plesk.
2. Crea un nuevo usuario con contraseña fuerte.
3. Asígnalo a tu base de datos con privilegios totales (ALL PRIVILEGES).

Paso 2: Actualiza wp-config.php

Reemplaza DB_USER y DB_PASSWORD con las nuevas credenciales.

Paso 3: Prueba

Recarga tu sitio. Si funciona, el usuario anterior tenía problemas.

Cómo prevenir este error en el futuro

¿Y si nada funciona?

Si probaste las 5 soluciones y el error persiste:

1. Contacta a tu hosting: un buen soporte técnico puede diagnosticar en 10-15 minutos.
2. Restaura desde backup: si tienes un backup del día anterior, restaura ahí.
3. Contrata migración asistida: muchas veces migrar a un hosting mejor resuelve el problema de raíz.

En Moshipp hacemos diagnóstico gratis: si tu WordPress tiene errores recurrentes con tu hosting actual, nuestro equipo revisa sin compromiso y te dice si es algo reparable o si conviene migrar.

Preguntas frecuentes

¿Perderé mi contenido al resolver este error?

No, a menos que borres archivos sin backup. El error es de CONEXIÓN, no de pérdida de datos. Tus posts, páginas y configuraciones siguen en la base de datos MySQL intactos; solo WordPress no puede leerlos. Una vez restablecida la conexión, todo aparece igual.

¿Por qué aparece de repente si todo funcionaba?

Causas comunes: (1) el proveedor cambió contraseñas o migró servidores, (2) alcanzaste límite de recursos tras un pico de visitas, (3) un plugin modificó wp-config.php, (4) actualizaste WordPress y quedó un archivo corrupto, o (5) el servidor MySQL tuvo un reinicio inesperado.

¿La reparación de WordPress borra datos?

No. La herramienta WP_ALLOW_REPAIR repara tablas dañadas, no elimina filas. Sin embargo, si una tabla estaba MUY corrupta, puede dejar campos vacíos que tendrás que completar manualmente. Siempre haz backup antes de ejecutarla.

¿Cómo sé si necesito más recursos de hosting?

Revisa el panel de tu hosting: si ves CPU al 80-100% frecuentemente o memoria al límite, necesitas más recursos. También si el error de BD aparece en horas de tráfico alto. Si es una tienda con mucho tráfico, lee nuestra guía de hosting WooCommerce.

¿Se puede prevenir con algún plugin?

No directamente, pero plugins de caché (LiteSpeed, WP Rocket, W3TC) reducen la carga sobre MySQL y así previenen errores por saturación. Plugins como Query Monitor ayudan a identificar consultas pesadas que puedes optimizar o eliminar.

¿Debo cambiar de hosting si me pasa seguido?

Si el error aparece varias veces al mes y tu soporte no lo resuelve definitivamente, sí conviene cambiar. Un hosting serio con MySQL bien configurado, recursos garantizados y monitoring activo previene este error casi por completo. Moshipp migra WordPress gratis desde cualquier proveedor.

Conclusión

El error “Error establishing a database connection” rara vez es grave. En la gran mayoría de casos lo resuelves con:

1. Recargar y esperar.
2. Corregir credenciales en wp-config.php.
3. Reparar BD con WP_ALLOW_REPAIR.
4. Revisar si el servidor MySQL funciona.
5. Escalar recursos si es por tráfico.

Si persiste tras intentar todas estas soluciones, probablemente tu hosting no está a la altura. Considera migrar a un proveedor con MySQL bien optimizado y soporte responsivo en español.