¿Cómo solucionar el "Error al establecer conexión con la base de datos" en WordPress? Imprimir

El error "Error al establecer conexión con la base de datos" (Error Establishing a Database Connection) es uno de los fallos más comunes en WordPress. Significa que el código PHP de tu sitio no puede comunicarse con la base de datos MySQL para consultar la información.

Paso 1: Verificar tus credenciales en wp-config.php

Debes comparar las credenciales del archivo de configuración con las configuradas en tu cPanel.

1. Inicia sesión en cPanel.
2. Abre el Administrador de archivos e ingresa a la carpeta donde está instalado tu WordPress (generalmente public_html).
3. Busca el archivo wp-config.php, haz clic derecho y selecciona Editar (Edit).
4. Busca las siguientes líneas de código y toma nota de los valores asignados:

   define( 'DB_NAME', 'nombre_de_base_de_datos' );
   define( 'DB_USER', 'usuario_de_base_de_datos' );
   define( 'DB_PASSWORD', 'contraseña_de_base_de_datos' );
   define( 'DB_HOST', 'localhost' );

Paso 2: Comprobar las credenciales en cPanel

1. Regresa a la página principal de cPanel.
2. Ve a la sección Bases de datos y abre Bases de datos MySQL.
3. Verifica si el nombre de la base de datos (Database) y el nombre de usuario (User) listados allí coinciden exactamente con los de tu wp-config.php (incluyendo el prefijo del usuario de cPanel, ej. usuario_bdname).
4. Si no estás seguro de si la contraseña es correcta, desplázate hasta la sección Usuarios actuales en la misma pantalla, busca el usuario y haz clic en Cambiar contraseña. Asigna una nueva contraseña fuerte y actualízala de inmediato en tu archivo wp-config.php.
5. Asegúrate de que el usuario de base de datos tenga **Todos los privilegios** asignados sobre la base de datos correspondiente (puedes enlazar el usuario con la base de datos en la sección inferior de la pantalla).

Paso 3: Reparar la base de datos de WordPress (Opcional)

Si las credenciales están perfectas pero el error persiste, o si ves un mensaje que dice que la base de datos necesita ser reparada:

1. Abre nuevamente tu archivo wp-config.php.
2. Añade la siguiente línea justo antes del texto /* That's all, stop editing! Happy publishing. */:

   define('WP_ALLOW_REPAIR', true);

3. Guarda los cambios y accede a la siguiente dirección en tu navegador: https://tudominio.cl/wp-admin/maint/repair.php (reemplaza por tu dominio real).
4. Haz clic en el botón Reparar base de datos.
5. Una vez finalizado el proceso, **elimina la línea** que agregaste en el archivo wp-config.php para evitar que terceros accedan a esa herramienta.