Arreglar conexión con la base de datos en WordPress

Qué significa el error al establecer una conexión con la base de datos

El error al establecer una conexión con la base de datos indica que WordPress no puede acceder a la información necesaria para cargar la web. En términos simples: los archivos de WordPress están ahí, pero no logran comunicarse con la base de datos donde se guardan entradas, páginas, ajustes, usuarios y gran parte del contenido.

Es un fallo de conexión entre WordPress y el servidor MySQL o MariaDB, y puede deberse a credenciales incorrectas, una base de datos dañada, una caída del servidor o problemas del hosting WordPress. Antes de tocar archivos o tablas, conviene hacer una copia de seguridad si tienes acceso al panel, al gestor de archivos o a phpMyAdmin.

1. Comprueba si el error afecta a toda la web y al área de administración.
2. Revisa el archivo wp-config.php y las credenciales MySQL.
3. Verifica en tu hosting si la base de datos y el servidor MySQL están operativos.
4. Si tienes acceso, prueba la reparación de tablas de WordPress.
5. Si el problema empezó tras un cambio reciente, revisa plugins, tema o migración.

Causas más habituales en WordPress

Cuando aparece este fallo de conexión con la base de datos, no siempre hay una única causa. Lo razonable es seguir un orden de diagnóstico para no empeorar la situación.

• Credenciales incorrectas en wp-config.php: nombre de base de datos, usuario, contraseña o host.
• Base de datos dañada o tablas corruptas tras un corte, actualización o error de escritura.
• Caída del servidor MySQL o saturación temporal del servicio.
• Límites del hosting, recursos agotados o incidencias del proveedor.
• Migraciones mal cerradas o cambios de dominio/servidor incompletos.
• Cambios recientes en plugins o en el tema que hayan disparado errores de acceso a la base de datos.

Si buscas una solución al error database connection WordPress, el punto clave es distinguir si se trata de un dato mal configurado, un problema interno de tablas o una incidencia del servidor.

Cómo revisar wp-config.php sin romper la web

El archivo de configuración de WordPress contiene los datos de acceso a la base de datos. Si tienes acceso por panel de control, SFTP o gestor de archivos, abre wp-config.php y revisa con cuidado estas constantes:

• DB_NAME: nombre de la base de datos.
• DB_USER: usuario con acceso a esa base.
• DB_PASSWORD: contraseña del usuario.
• DB_HOST: host del servidor de base de datos, que según tu hosting puede no ser siempre localhost.

Compáralos con los datos reales del panel de hosting. Un solo carácter incorrecto basta para perder el acceso a la base de datos. No cambies otras líneas si no estás segura de su función y guarda siempre una copia del archivo antes de editarlo.

Si el error empezó justo después de una migración o un cambio de hosting WordPress, conviene revisar primero este archivo, porque es una de las causas más frecuentes.

Qué comprobar en el hosting y en el servidor MySQL

No todos los problemas dependen de WordPress. A veces la incidencia está en el entorno del servidor. Desde tu panel de hosting, si lo tienes disponible, conviene revisar:

• Si la base de datos existe y sigue asociada al usuario correcto.
• Si hay avisos de caída del servidor, mantenimiento o errores de MySQL.
• Si se han alcanzado límites de recursos, conexiones o espacio.
• Si otras webs del mismo alojamiento presentan síntomas similares.

Si no puedes confirmar el estado del servicio, lo más prudente es abrir ticket con el proveedor y pedir que verifiquen el servidor MySQL, los logs y el acceso real de ese usuario a la base de datos.

Cómo reparar la base de datos de WordPress paso a paso

Si las credenciales son correctas pero sospechas corrupción de tablas, puedes reparar base de datos WordPress con cautela. Una opción conocida es activar temporalmente WP_ALLOW_REPAIR en wp-config.php, tal como recoge la documentación oficial de WordPress.

1. Haz copia de seguridad de archivos y base de datos si te es posible.
2. Añade temporalmente la constante WP_ALLOW_REPAIR en el archivo de configuración.
3. Accede a la herramienta de reparación que WordPress habilita para este fin.
4. Ejecuta la reparación y, si procede, la optimización.
5. Elimina después la constante para no dejar esa función expuesta.

Si prefieres usar phpMyAdmin, algunos hostings permiten reparar tablas desde la propia interfaz. Aun así, conviene actuar con cuidado: reparar no equivale a recuperar cualquier daño complejo, y una tabla muy afectada puede requerir restaurar copia de seguridad.

Referencia oficial de WordPress sobre wp-config.php

Cuándo el problema puede venir de plugins, tema o migraciones

Aunque el mensaje apunte a la base de datos, el origen puede estar en un cambio reciente. Si instalaste un plugin, actualizaste el tema o moviste la web de servidor, conviene tenerlo en cuenta.

En migraciones, por ejemplo, es habitual que queden mal ajustadas las credenciales de la base de datos o el valor de DB_HOST. En otros casos, un plugin puede disparar consultas problemáticas o dejar la web inestable tras una actualización incompleta.

Si tienes acceso a archivos pero no al panel, puedes desactivar temporalmente plugins renombrando su carpeta para comprobar si cambia el comportamiento. Hazlo solo si sabes identificar la estructura de WordPress y anota cualquier cambio para poder revertirlo.

Qué hacer si nada funciona

Si ya has revisado el archivo de configuración de WordPress, el estado del hosting, las credenciales de la base de datos y la reparación de tablas, lo más sensato es detener cambios improvisados. Seguir probando sin diagnóstico puede complicar la recuperación.

• Restaura una copia de seguridad reciente si dispones de una versión sana.
• Pide al hosting revisión de logs, estado de MySQL y permisos del usuario de base de datos.
• Evita editar varias cosas a la vez: así sabrás qué cambio afecta realmente.
• No elimines tablas ni reinstales WordPress sin confirmar antes el alcance del problema.

En resumen, para reparar WordPress ante este error conviene seguir un orden: copia de seguridad, revisión de wp-config.php, comprobación del servidor MySQL, reparación de tablas si procede y análisis de cambios recientes. Si no puedes acceder o prefieres no tocar archivos críticos, el siguiente paso razonable es contar con soporte técnico especializado para revisar la incidencia sin poner en riesgo la web.