Cómo solucionar el error de conexión con la base de datos en WordPress
«Error al establecer una conexión con la base de datos.» Este mensaje aparece cuando WordPress no puede conectarse a MySQL y deja la web completamente en blanco. Aunque parece grave, las causas son bastante concretas y en la mayoría de casos se resuelve en minutos siguiendo las causas en orden.
Causa 1: credenciales incorrectas en wp-config.php
La causa más frecuente después de una migración o cambio de hosting. El wp-config.php tiene las credenciales de conexión a la base de datos: nombre de la base de datos, usuario, contraseña y host. Si alguna no coincide con la base de datos real del servidor, WordPress no puede conectarse.
Abre el wp-config.php con FTP o el administrador de archivos de cPanel y verifica estas cuatro líneas:
define('DB_NAME', 'nombre_de_la_base_de_datos');
define('DB_USER', 'usuario_de_mysql');
define('DB_PASSWORD', 'contraseña_de_mysql');
define('DB_HOST', 'localhost');
En cPanel, las bases de datos MySQL están en la sección «Bases de datos MySQL». Verifica que la base de datos existe, que el usuario existe, que el usuario tiene permisos asignados y que la contraseña es correcta. El valor de DB_HOST es casi siempre «localhost» en hosting compartido, pero en algunos proveedores puede ser una dirección IP o un hostname diferente.
Causa 2: el servidor MySQL está caído
Si las credenciales son correctas y el error persiste, puede que el servidor MySQL esté caído temporalmente por sobrecarga, mantenimiento o un problema del servidor. Para verificarlo: intenta acceder a phpMyAdmin desde cPanel. Si phpMyAdmin tampoco carga o muestra error de conexión, el problema está en el servidor MySQL, no en tu instalación.
En ese caso la solución está en manos del proveedor de hosting. Abre un ticket indicando que MySQL no responde y comprueba si hay incidencias activas reportadas en el panel de estado.
Causa 3: la base de datos está corrupta
Una base de datos corrupta puede impedir la conexión o causar errores intermitentes. Ocurre después de una caída del servidor sin cierre correcto de MySQL o de una interrupción durante una operación de escritura.
Para reparar desde phpMyAdmin: selecciona la base de datos, ve a la pestaña «SQL» y ejecuta:
REPAIR TABLE wp_options, wp_posts, wp_postmeta, wp_users, wp_usermeta;
WordPress también tiene una herramienta de reparación integrada. Añade esta línea al wp-config.php:
define('WP_ALLOW_REPAIR', true);
Luego accede a tudominio.com/wp-admin/maint/repair.php. Después de la reparación, elimina esa línea del wp-config.php.
Causa 4: el servidor ha superado el límite de conexiones
MySQL tiene un límite configurable de conexiones simultáneas. En hosting compartido con muchos sitios en el mismo servidor, ese límite puede alcanzarse en picos de tráfico. El error de WordPress es el mismo que con credenciales incorrectas, pero la causa es diferente.
Si el error aparece solo en picos de tráfico y desaparece después, probablemente es un problema de conexiones simultáneas. Si el error es constante, las causas 1, 2 o 3 son más probables.
A corto plazo, activar la caché de WordPress reduce drásticamente el número de conexiones a la base de datos porque las páginas cacheadas no necesitan hacer consultas SQL.
Diagnosticar con WordPress en modo debug
Con el modo debug activo, WordPress muestra mensajes de error más específicos. Añade al wp-config.php:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Los errores se guardan en wp-content/debug.log. Después de diagnosticar, desactiva el modo debug cambiando los valores a false.