Error de conexión a la base de datos en WordPress

El mensaje “Error establishing a database connection” (Error al establecer una conexión con la base de datos) significa que WordPress no pudo conectarse a su base de datos. Casi siempre se debe a que los datos guardados en wp-config.php no coinciden con la base, el usuario o la contraseña configurados en cPanel. Suele aparecer después de una migración, de cambiar una contraseña o de restaurar una copia.

Antes de empezar: descarga una copia de wp-config.php para poder deshacer cualquier cambio. No compartas su contenido ni lo muestres en una captura: incluye la contraseña de la base de datos.

1. Comprueba que la base de datos y el usuario existen

1. Inicia sesión en cPanel y abre Bases de datos › Administrar mis bases de datos (Databases › Manage My Databases).
2. En Bases de datos actuales (Current Databases) busca la base de datos de tu sitio.
3. En la columna Usuarios privilegiados (Privileged Users) confirma que el usuario de WordPress está asignado a esa base.
4. Ten en cuenta que cPanel añade tu nombre de usuario como prefijo: la base wp se llama en realidad algo como micuenta_wp. Usa siempre el nombre completo.

Si el usuario no aparece asignado, agrégalo en Agregar usuario a la base de datos (Add User To Database) con Todos los privilegios (All Privileges). Si falta la base o el usuario, sigue Crear una base de datos MySQL.

2. Compara los cuatro datos de wp-config.php

Abre wp-config.php (en la carpeta de tu WordPress, normalmente public_html) con el Administrador de archivos y revisa estas líneas:

Ajuste	Qué debe contener
DB_NAME	El nombre completo de la base de datos, con el prefijo de cPanel.
DB_USER	El nombre completo del usuario asignado a esa base.
DB_PASSWORD	La contraseña actual de ese usuario de base de datos (no la de cPanel).
DB_HOST	localhost: en tu plan la base de datos está en el mismo servidor que el sitio.

Corrige el valor que no coincida, guarda el archivo y recarga el sitio. Cambia solo un dato a la vez para saber cuál era el problema.

3. Si no recuerdas la contraseña del usuario

No hace falta recuperarla: puedes poner una nueva.

1. En Administrar mis bases de datos, baja hasta Usuarios actuales (Current Users).
2. Haz clic en Cambiar contraseña (Change Password) junto al usuario de WordPress y genera una contraseña segura.
3. Copia esa misma contraseña en DB_PASSWORD dentro de wp-config.php y guarda.

4. Lo que no conviene hacer

• No borres, renombres ni “repares” la base de datos sin una copia de seguridad: puedes perder el contenido del sitio. Descarga una copia antes desde Copias de seguridad.
• No cambies DB_HOST por ensayo y error.
• No reinstales WordPress encima del sitio: no resuelve el problema de conexión y puede sobrescribir archivos.

Si el error continúa

Puede haber una tabla dañada o un problema temporal del servidor. Escríbenos indicando:

• El dominio y la hora aproximada del error.
• El mensaje exacto que ves.
• Si empezó después de una migración, de cambiar una contraseña o de restaurar una copia.
• Qué comprobaste de esta guía.

No incluyas la contraseña ni el archivo wp-config.php. Consulta Cómo pedir ayuda a soporte para preparar tu consulta.