Cómo solucionar "Error establishing a database connection" en WordPress

¿Qué significa este error?

El mensaje "Error establishing a database connection" significa que WordPress no puede conectarse a la base de datos MySQL que almacena el contenido, configuración, usuarios y publicaciones de su sitio. Es un error crítico que hace que todo el sitio sea inaccesible.

Causas comunes

  • Credenciales de base de datos incorrectas en wp-config.php
  • El servidor de base de datos MySQL está caído o no responde
  • La base de datos está corrupta
  • El usuario de la base de datos no tiene privilegios suficientes
  • El servidor ha excedido sus límites de recursos

Paso 1: Verificar las credenciales de la base de datos

Abra wp-config.php en la raíz de su instalación de WordPress y verifique estos cuatro valores:

define('DB_NAME', 'nombre_de_su_base_de_datos');
define('DB_USER', 'su_usuario_de_base_de_datos');
define('DB_PASSWORD', 'su_contraseña');
define('DB_HOST', 'localhost');

Luego verifique que las credenciales sean correctas:

  1. Inicie sesión en cPanel.
  2. Vaya a Bases de datos MySQL.
  3. Confirme que la base de datos indicada en DB_NAME exista en Bases de datos actuales.
  4. Confirme que el usuario indicado en DB_USER esté asignado a esa base de datos con Todos los privilegios.
  5. Si la contraseña es incorrecta, haga clic en Cambiar contraseña del usuario, establezca una nueva y actualice wp-config.php.

Paso 2: Verificar si el servidor de base de datos está en ejecución

Si las credenciales son correctas pero el error persiste, el servidor MySQL puede estar caído. Puede verificarlo:

  • Intentando acceder a phpMyAdmin desde cPanel. Si phpMyAdmin tampoco carga, el servidor de base de datos probablemente está caído.
  • Contactando al equipo de soporte de su proveedor de hosting para verificar el estado del servicio MySQL.

Paso 3: Reparar la base de datos

Si la base de datos existe pero puede estar corrupta, WordPress tiene una herramienta de reparación integrada:

  1. Agregue esta línea a wp-config.php:
define('WP_ALLOW_REPAIR', true);
  1. Visite https://sudominio.com/wp-admin/maint/repair.php.
  2. Haga clic en Repair Database (o Repair and Optimize Database para una reparación más completa).
  3. Una vez completado, elimine la línea de wp-config.php — dejarla habilitada es un riesgo de seguridad.

Paso 4: Verificar los privilegios del usuario de base de datos

En cPanel, dentro de Bases de datos MySQL:

  1. Busque el usuario de la base de datos en Bases de datos actuales.
  2. Haga clic en el usuario para ver los privilegios.
  3. Asegúrese de que Todos los privilegios esté marcado.
  4. Haga clic en Guardar cambios.

Paso 5: Verificar el valor de DB_HOST

La mayoría de proveedores de hosting usan localhost como host de la base de datos. Sin embargo, algunos proveedores requieren un nombre de host o dirección IP específica. Consulte con su proveedor de hosting si no está seguro.

Si el problema persiste

Si ninguno de los pasos anteriores resuelve el problema, el servidor puede estar bajo carga excesiva o haber excedido sus límites de recursos. Contacte al soporte de Telecu Cloud para obtener asistencia.