Error de conexión a base de datos WordPress | Soluciones

¿Tu sitio web en WordPress muestra el temido mensaje "Error al establecer conexión con la base de datos"? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene solución. Este error significa que WordPress no puede comunicarse con el servidor MySQL donde se almacenan tus publicaciones, usuarios y configuraciones.

Vamos a solucionarlo paso a paso, como si estuviéramos sentados frente a tu ordenador. Sigue esta guía, desde lo más simple hasta lo más técnico, y recuperarás tu sitio en pocos minutos.

¿Por qué ocurre este error?

Antes de lanzarnos a editar archivos, entendamos las causas principales. El error conexión base datos WordPress suele deberse a:

Credenciales incorrectas en el archivo wp-config.php.
El servidor de base de datos (MySQL) está caído o sobrecargado.
Archivos corruptos de WordPress (por actualización fallida o ataque).
Problemas de permisos en el hosting o en la base de datos.
Configuración incorrecta del servidor (puertos, direcciones IP, etc.).

Paso 1: Verifica si el problema es general o específico

Primero, haz una prueba rápida: accede a cualquier otra página de tu mismo hosting (si tienes otro sitio o un subdominio). Si también falla, el problema es del servidor. Si solo falla tu WordPress, el error está en tu instalación.

[INFO] Si el problema es de todo el servidor, contacta con tu proveedor de hosting. Si solo es WordPress, continúa con los pasos siguientes.

Paso 2: Revisa el estado de tu base de datos MySQL

Accede al panel de control de tu hosting. Si usas Syspanel (el panel basado en HestiaCP, accesible por el puerto 2106), busca la sección "Bases de Datos" o "MySQL". Allí verás:

El nombre de tu base de datos.
El usuario y la contraseña.
El host (normalmente localhost, pero a veces es una IP como 127.0.0.1 o un servidor remoto).

Asegúrate de que la base de datos existe y no está corrupta. Si ves un mensaje de error como "Base de datos no encontrada", deberás crearla de nuevo (pide ayuda a tu hosting si no sabes hacerlo).

[WARNING] No modifiques los datos de la base de datos directamente a menos que sepas lo que haces. Un cambio incorrecto puede romper todo.

Paso 3: Edita el archivo `wp-config.php` (la causa más común)

El archivo wp-config.php contiene las credenciales de acceso a MySQL. Si están mal escritas, WordPress no puede conectar.

¿Cómo acceder al archivo?

Conéctate a tu hosting vía FTP (FileZilla, por ejemplo) o al gestor de archivos desde Syspanel (puerto 2106, sección "Archivos").
Navega hasta la carpeta raíz de WordPress (normalmente public_html o htdocs).
Busca el archivo wp-config.php. Si no lo ves, puede estar oculto. Activa la opción "Mostrar archivos ocultos" en tu cliente FTP.

¿Qué debes revisar?

Abre el archivo con un editor de texto (nunca con Word). Busca estas líneas:

define('DB_NAME', 'tu_base_de_datos');
define('DB_USER', 'tu_usuario');
define('DB_PASSWORD', 'tu_contraseña');
define('DB_HOST', 'localhost');

Verifica que:

DB_NAME coincida exactamente con el nombre de tu base de datos (mayúsculas/minúsculas importan).
DB_USER sea el usuario correcto.
DB_PASSWORD sea la contraseña real (si la cambiaste, actualízala aquí).
DB_HOST normalmente es localhost. Si tu hosting usa un servidor remoto, puede ser algo como mysql.tudominio.com o una IP. Pregunta a tu hosting si no estás seguro.

[TIP] Si cambiaste la contraseña de la base de datos desde el panel de control, debes actualizarla también en wp-config.php. Si no, obtendrás el error.

¿Qué hacer si no encuentras el archivo?

Si no existe wp-config.php, es posible que tu instalación esté corrupta. Descarga WordPress desde wordpress.org, extrae el archivo wp-config-sample.php, renómbralo a wp-config.php y rellena los datos. Luego súbelo a tu servidor.

Paso 4: Restablece la conexión desde Syspanel (si usas este panel)

Si tu hosting usa Syspanel (HestiaCP), hay una opción muy útil para regenerar la configuración de la base de datos.

Accede a Syspanel a través de https://tudominio.com:2106 (puerto 2106).
Ve a "Bases de Datos".
Busca tu base de datos y haz clic en "Reparar" o "Verificar" (depende de la versión). Esto revisará la integridad de las tablas.
También puedes "Vaciar" la base de datos (¡cuidado! esto borra todo) y luego importar una copia de seguridad.

[WARNING] No vacíes la base de datos sin tener una copia de seguridad reciente. Si no tienes respaldo, omite este paso.

Paso 5: Verifica que el servidor MySQL esté funcionando

A veces el problema no es de WordPress, sino del servidor. Si tienes acceso a la terminal (SSH) o a un panel como cPanel, busca el estado de MySQL.

En Syspanel, ve a "Servicios" y busca "MySQL" o "MariaDB". Debería estar en verde (activo). Si está en rojo, intenta reiniciarlo desde el mismo panel.

Si no tienes acceso, contacta a tu proveedor de hosting y pregunta: "¿El servicio MySQL está funcionando correctamente?".

Paso 6: Prueba con un plugin de emergencia (si puedes acceder al admin)

Si el error aparece solo en algunas páginas o después de instalar un plugin, puedes intentar desactivar todos los plugins desde la base de datos. Esto es un poco más técnico, pero funciona:

Accede a la base de datos desde Syspanel (sección "phpMyAdmin" o "Base de datos").
Busca la tabla wp_options (el prefijo puede ser diferente, como wp_).
Localiza la fila donde option_name es active_plugins.
Cambia el valor por a:0:{} (esto vacía la lista de plugins activos).
Guarda los cambios. Luego ve a tu sitio y reactiva los plugins uno por uno desde el admin.

[INFO] Este método desactiva todos los plugins. Si el error desaparece, sabrás que uno de ellos era el culpable.

Paso 7: Reemplaza archivos principales de WordPress

Si todo lo anterior falla, es posible que tengas archivos corruptos. Descarga una copia limpia de WordPress desde wordpress.org (misma versión que usas).

Luego, a través de FTP, reemplaza las carpetas wp-admin y wp-includes y el archivo wp-config.php (pero conserva tu wp-config.php original, solo reemplaza los otros). No toques la carpeta wp-content (ahí están tus temas y plugins).

[WARNING] No subas todo el WordPress, solo las carpetas mencionadas. Si subes wp-content, perderás tus personalizaciones.

Paso 8: Contacta a tu soporte técnico

Si después de todos estos pasos el error conexión base datos WordPress persiste, es hora de pedir ayuda profesional. Proporciona a tu hosting la siguiente información:

El mensaje exacto de error.
Qué pasos has intentado.
Capturas de pantalla (si es posible).
Tu nombre de dominio y usuario de hosting.

Ellos pueden revisar los logs del servidor y detectar problemas más profundos, como límites de memoria, firewalls o configuraciones de PHP.

Preguntas frecuentes (FAQ)

¿Por qué aparece "Error establishing a database connection" después de mover mi sitio?

Al cambiar de hosting o dominio, las credenciales de la base de datos cambian. Debes actualizar wp-config.php con los nuevos datos.

¿El error puede deberse a un ataque?

Sí, los ataques pueden corromper archivos o la base de datos. Si sospechas de un ataque, cambia todas las contraseñas (WordPress, FTP, base de datos) y escanea tu sitio con un plugin de seguridad.

¿Cómo sé si mi base de datos está corrupta?

Desde phpMyAdmin, selecciona tu base de datos y haz clic en "Verificar" o "Reparar". Si aparecen errores, usa la opción "Reparar" (esto puede tardar unos segundos).

¿Qué hago si no recuerdo la contraseña de la base de datos?

En Syspanel (puerto 2106), ve a "Bases de Datos", selecciona tu base de datos y haz clic en "Cambiar contraseña". Luego actualiza wp-config.php con la nueva contraseña.

¿Puedo usar el mismo nombre de usuario y contraseña que en el panel de hosting?

No necesariamente. La base de datos tiene su propio usuario y contraseña, que configuraste al instalar WordPress. No uses las credenciales de tu cuenta de hosting.

Resumen final

El error conexión base datos WordPress es frustrante, pero casi siempre se soluciona con un ajuste en wp-config.php o verificando que el servidor MySQL esté activo. Recuerda:

Revisa las credenciales en wp-config.php.
Verifica el estado de MySQL desde tu panel de hosting (Syspanel, puerto 2106).
Prueba desactivando plugins desde la base de datos.
Reemplaza archivos corruptos de WordPress.
Pide ayuda a tu hosting si nada funciona.

Con estos pasos, tu sitio volverá a la vida en cuestión de minutos. ¡No te rindas!