WordPress: Error al establecer una conexión con la base de datos

Qué significa este error y cómo reconocerlo

• El sitio muestra únicamente “Error establishing a database connection”, a menudo en todas las páginas públicas.
• /wp-admin/ tampoco está disponible porque utiliza la misma conexión con la base de datos.
• El error puede aparecer después de una migración, un cambio de hosting, una restauración de la base de datos, una edición manual de wp-config.php, un restablecimiento de contraseña o un reinicio del servidor de bases de datos.
• Si solo fallan determinadas páginas mientras otras páginas que usan la base de datos funcionan, el problema puede ser específico de una página, plugin, tema o consulta, en lugar de un fallo completo de la conexión con la base de datos.

Causas principales, ordenadas por probabilidad

1. Credenciales incorrectas en wp-config.php — DB_NAME, DB_USER, DB_PASSWORD o DB_HOST ya no coinciden con la configuración actual de la base de datos. Es especialmente habitual después de una migración, restauración, cambio de contraseña o edición manual.
2. Un servidor MySQL o MariaDB no disponible — el servicio puede haberse detenido, bloqueado o dejado de estar disponible debido a un problema de recursos del hosting.
3. El host de base de datos incorrecto — localhost puede no ser válido cuando la base de datos se ejecuta en otro servidor o contenedor, mientras que un valor de host remoto puede haber dejado de coincidir con el entorno actual.
4. Falta de permisos para el usuario de la base de datos — el usuario puede existir, pero no estar asignado a la base de datos de WordPress o no tener los permisos necesarios para utilizarla.
5. Tablas de la base de datos dañadas — una escritura interrumpida, un cierre incorrecto o un problema de disco pueden dañar las tablas, aunque esto suele ser menos probable que un problema de configuración o disponibilidad.

Cómo solucionarlo

1. Confirma el alcance del fallo

Abre el sitio público y /wp-admin/. Si ambos muestran el error de conexión, continúa con las comprobaciones de la base de datos que se indican a continuación. Si solo falla una página o función, revisa el plugin, tema, consulta o error de la aplicación específico en lugar de asumir que toda la conexión con la base de datos no está disponible.

2. Comprueba si MySQL o MariaDB está en ejecución

En un VPS o servidor dedicado del que seas responsable, comprueba el estado del servicio correspondiente. Estos comandos son de solo lectura y requieren acceso al shell:

systemctl status mysql

Si el servidor utiliza MariaDB, comprueba lo siguiente:

systemctl status mariadb

En un hosting compartido o gestionado, utiliza la información sobre el estado de la base de datos del panel de hosting o pide al proveedor que compruebe el servicio y los límites de recursos. Reinicia un servicio de base de datos únicamente si administras ese servidor, tienes la autorización correspondiente y has confirmado que el impacto operativo es aceptable; un reinicio puede interrumpir las conexiones activas con la base de datos.

3. Verifica los cuatro ajustes de la base de datos en wp-config.php

Utiliza SFTP o el administrador de archivos del hosting para abrir wp-config.php. Compara estos valores con los datos actuales de la base de datos en el panel de hosting o en los registros de la migración:

• DB_NAME — la base de datos que debe utilizar WordPress
• DB_USER — el nombre de usuario de la base de datos
• DB_PASSWORD — la contraseña actual de ese usuario
• DB_HOST — la dirección o configuración del host del servidor de bases de datos

Comprueba si el nombre de la base de datos está obsoleto, la contraseña desactualizada, el host es incorrecto o se han introducido accidentalmente cambios en los espacios en blanco o las comillas. No des por hecho que los valores anteriores siguen siendo válidos después de una migración, un cambio de hosting, una restauración de la base de datos o un restablecimiento de contraseña.

4. Prueba la misma conexión fuera de WordPress

Utiliza phpMyAdmin o la línea de comandos de MySQL con el nombre de la base de datos, el nombre de usuario, la contraseña y el host exactos de wp-config.php. Esta prueba debe utilizar el mismo entorno y las mismas credenciales que WordPress.

• Si la conexión directa falla, investiga las credenciales, el host de la base de datos, la disponibilidad del servidor o el acceso de red antes de cambiar archivos de WordPress.
• Si la conexión directa funciona, la ruta básica del servidor y las credenciales es correcta; continúa comprobando la asignación del usuario a la base de datos, los permisos y el estado de las tablas.

No publiques la contraseña ni el archivo wp-config.php completo al solicitar ayuda.

5. Confirma el acceso y los permisos del usuario de la base de datos

En la sección de usuarios de bases de datos del panel de hosting, verifica que el usuario de wp-config.php esté asignado a la base de datos correcta de WordPress y tenga permiso para leer y modificar sus tablas. Esta comprobación es especialmente importante después de restaurar una base de datos en una cuenta nueva o crear un usuario de sustitución.

Si administras MySQL directamente, un administrador autorizado puede consultar los permisos de la cuenta con SHOW GRANTS. Corrige la asignación del usuario a la base de datos o los permisos solo después de confirmar que la base de datos y la cuenta son las previstas. Después, repite la prueba de conexión directa y vuelve a cargar el sitio.

6. Comprueba si hay problemas en las tablas solo después de que la conexión funcione

Si el servidor de bases de datos está disponible, las credenciales exactas funcionan en una prueba directa y el usuario tiene acceso, inspecciona las tablas de WordPress en phpMyAdmin o mediante una herramienta de base de datos autorizada. CHECK TABLE puede informar de problemas en las tablas.

Crea o verifica una copia de seguridad actual de la base de datos antes de intentar cualquier reparación. REPAIR TABLE es principalmente pertinente para tablas MyISAM compatibles y no es un método de reparación universal. No ejecutes comandos de reparación repetidamente cuando las comprobaciones no indiquen corrupción; vuelve a revisar el host, la configuración, los permisos y los logs del servidor para continuar el diagnóstico.

7. Verifica todo el sitio después de solucionar el problema

Carga varias páginas públicas y /wp-admin/. Si ambas funcionan, borra únicamente las capas de caché pertinentes si sigue apareciendo contenido obsoleto. Si alguna de las dos áreas continúa fallando, registra el mensaje exacto actual y revisa los logs del servidor o del hosting en lugar de asumir que el problema de conexión original no ha cambiado.

Prevención y cómo verificar la solución

• Guarda los datos actuales del nombre de la base de datos, usuario, host y contraseña en un gestor de contraseñas protegido o en otro registro seguro equivalente.
• Después de cada migración o cambio de hosting, prueba el sitio público y /wp-admin/ antes de completar el traslado.
• Mantén copias de seguridad periódicas de la base de datos y confirma regularmente que es posible restaurarlas.
• Registra qué usuario de base de datos está asignado a cada base de datos de WordPress para que una restauración o sustitución de usuario no elimine el acceso sin avisar.
• Revisa las alertas de recursos del hosting y los eventos del servicio de base de datos cuando estén disponibles, especialmente después de reinicios inesperados o fallos de conexión recurrentes.
• Limita el acceso a wp-config.php y evita compartir su contenido o sus credenciales en solicitudes de soporte.

Preguntas frecuentes