Cómo corregir Error establishing a database connection en WordPress desde cPanel

El mensaje Error establishing a database connection aparece cuando tu sitio no puede conectarse a la base de datos MySQL que necesita para cargar. En hosting compartido casi siempre conviene empezar revisando wp-config.php, el usuario MySQL y los permisos desde cPanel antes de cambiar plugins o temas.

Antes de empezar

• Ten acceso a cPanel y al Administrador de archivos.
• Identifica la carpeta donde está instalado el sitio, normalmente public_html.
• Ten a la mano el nombre de la base de datos, usuario y contraseña si los guardaste al instalar el sitio.
• Haz una copia del archivo wp-config.php antes de editarlo.

Pasos

1. Abre Administrador de archivos o Administrador de archivos en cPanel y entra a la carpeta del sitio.
2. Localiza wp-config.php, descarga una copia y luego ábrelo con Editar.
3. Revisa que DB_NAME, DB_USER, DB_PASSWORD y DB_HOST tengan valores completos, sin espacios extra ni comillas faltantes.
4. En cPanel abre Bases de datos MySQL® o Asistente de base de datos y confirma que la base de datos indicada en DB_NAME exista.
5. Revisa que el usuario indicado en DB_USER exista y esté asignado a esa base de datos con los privilegios necesarios.
6. Si no conoces la contraseña actual, crea una nueva para el usuario MySQL y actualiza el mismo valor en DB_PASSWORD dentro de wp-config.php.
7. Guarda el archivo, recarga el sitio en una ventana privada y revisa si ya carga sin el error.

Cómo verificar que quedó resuelto

• El sitio abre sin mostrar Error establishing a database connection.
• El archivo wp-config.php guarda el mismo nombre de base de datos y usuario que ves en cPanel.
• El usuario MySQL aparece asignado a la base de datos correcta.
• El panel de administración abre en /wp-admin sin regresar al error de conexión.

Errores comunes

• El error sigue igual después de guardar → hay una credencial distinta entre wp-config.php y cPanel → compara nombre de base, usuario, contraseña y host uno por uno.
• cPanel muestra la base de datos pero no el usuario asignado → el usuario no tiene permisos sobre esa base → vuelve a asignarlo con privilegios desde Bases de datos MySQL®.
• El sitio cambia a error 500 después de editar → se dañó la sintaxis de wp-config.php → restaura la copia que descargaste y repite el cambio con cuidado.

Cuándo pedir ayuda

Si las credenciales coinciden y el error continúa, puede haber tablas dañadas, límites temporales de conexiones MySQL o un problema en el servidor. En ese caso, comparte con soporte la hora del error, el dominio afectado y que ya validaste wp-config.php contra cPanel.