Este mensaje significa que WordPress no ha podido establecer o mantener la conexión MySQL necesaria para cargar los datos. La causa puede ser una credencial incorrecta, MySQL no disponible, un host o socket equivocado, conexiones agotadas o infraestructura dañada.
No reinstales WordPress ni importes primero una copia antigua. Podrías sobrescribir contenido actual sin reparar la conectividad.
Delimita el alcance de la caída
Prueba la web pública, wp-admin, otra web autorizada del mismo servidor que use base de datos y el panel de MySQL del hosting. Anota la hora y si el fallo es constante o intermitente.
Si solo falla una instalación, céntrate en su configuración y usuario. Si fallan todas, investiga el servicio MySQL y la capacidad del servidor.
Evita recargar repetidamente cuando las conexiones están saturadas.
Conserva la configuración de forma segura
Haz copia de wp-config.php y anota la estructura de DB_NAME, DB_USER y DB_HOST sin copiar la contraseña en tickets.
define( 'DB_NAME', 'database_name' );
define( 'DB_USER', 'database_user' );
define( 'DB_HOST', 'localhost' );Después de una migración, busca espacios ocultos, comillas incorrectas y definiciones duplicadas. Cambia cualquier contraseña que haya quedado expuesta.
Prueba las credenciales fuera de WordPress
Usa las herramientas MySQL de cPanel o Plesk, o el cliente desde el mismo servidor. Una conexión desde tu ordenador no demuestra que PHP alcance el socket o host configurado.
Clasifica el resultado:
access denied -> credenciales o permisos
connection refused -> servicio o listener
unknown host -> DNS o nombre
too many connections -> capacidad o fuga
timeout -> red, cortafuegos o cargaNo escribas la contraseña directamente en el historial del terminal.
Revisa servicio y recursos de MySQL
Comprueba estado, registro de errores, disco, RAM, lista de procesos y número de conexiones. MySQL puede estar activo y aun así rechazar trabajo mientras recupera tablas o alcanza el máximo.
No reinicies antes de guardar pruebas y evaluar escrituras activas. Un reinicio puede revertir transacciones y ocultar temporalmente una fuga.
En hosting gestionado, utiliza sus controles y registro de incidentes.
Verifica los permisos del usuario
El usuario debe acceder a la base prevista desde el host de conexión. Una migración puede recrear la base sin volver a asociar usuario y privilegios.
Desde cPanel o Plesk asigna el usuario correcto con los permisos que requiere WordPress. No concedas privilegios globales ni acceso remoto desde cualquier dirección.
Confirma que las tablas con el prefijo de WordPress existen; conectar a una base vacía o incorrecta causa un síntoma distinto.
Revisa socket, puerto y hostname
localhost puede utilizar un socket Unix mientras 127.0.0.1 utiliza TCP. Algunos proveedores facilitan otro nombre o puerto de base de datos.
Usa el valor documentado. No cambies a ciegas: socket y TCP pueden tener usuarios, cortafuegos y rendimiento distintos.
Después de modificar DNS o servidor de datos, verifica la resolución desde PHP y considera los registros en caché.
Investiga pérdidas intermitentes
Relaciona fallos con consultas lentas, picos de conexiones, copias e importaciones. Un plugin que abre conexiones sin gestionarlas o ejecuta consultas largas puede agotar la capacidad.
Utiliza métricas MySQL y registros PHP para encontrar el origen antes de subir max_connections; cada conexión consume memoria.
En webs con varios nodos, comprueba que todos utilizan el mismo endpoint.
Comprueba drop-ins y caché persistente
Revisa wp-content/db.php y object-cache.php. Algunos proveedores y plugins sustituyen la clase normal de base de datos o envían lecturas a réplicas. Un drop-in antiguo copiado en una migración puede apuntar a un host inexistente aunque wp-config.php sea correcto.
Retíralo temporalmente solo mediante el procedimiento documentado y tras hacer copia. Confirma que las lecturas posteriores a una escritura no llegan a una réplica retrasada y que todos los nodos tienen la misma configuración.
Repara y verifica escrituras
Corrige credencial, permiso, host, servicio o capacidad según las pruebas. Después prueba páginas, acceso, guardado de un borrador controlado, metadatos de medios y tareas programadas.
Vigila errores y conexiones al reabrir. El mantenimiento recurrente debería alertar por disco, salud del servicio y saturación; la reparación termina cuando lecturas y escrituras permanecen estables.