Error de conexión a base de datos WordPress: causas y solución

¿Tu sitio web en WordPress ha dejado de funcionar y ves un mensaje que dice "Error de conexión a la base de datos"? No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene solución. En esta guía completa, paso a paso, te voy a explicar cómo solucionar el error conexión base datos WordPress para que tu web vuelva a estar online lo antes posible. Vamos a empezar desde lo más básico hasta lo más técnico, pero siempre de forma clara y sencilla.

¿Qué significa este error y por qué aparece?

Cuando visitas tu sitio y ves el mensaje "Error de conexión a la base de datos" (o en inglés "Database connection error"), significa que WordPress no puede comunicarse con la base de datos donde se almacenan tus contenidos, usuarios y configuraciones. Sin esa conexión, tu web no puede cargar nada.

Las causas más frecuentes de este WordPress error base de datos son:

Datos de conexión incorrectos en el archivo de configuración.
La base de datos ha sido dañada o corrompida.
El servidor de base de datos (MySQL/MariaDB) está caído o sobrecargado.
Problemas con el plugin de caché o algún otro plugin conflictivo.
El hosting ha realizado cambios en los accesos o en la configuración del servidor.

Paso 1: Verifica que el error no sea temporal

Antes de entrar en pánico, refresca la página varias veces. A veces el servidor de base de datos se reinicia o tiene una sobrecarga momentánea y el problema se resuelve solo.

[TIP] Si el error aparece de repente y desaparece al recargar, es probable que sea un pico de tráfico o un mantenimiento del servidor. Espera unos minutos y vuelve a intentarlo.

Si el error persiste, sigue leyendo.

Paso 2: Accede a tu panel de control (cPanel o Syspanel)

Para solucionar el WordPress no conecta base datos, necesitas acceder al panel de control de tu hosting. Dependiendo de tu proveedor, puede ser cPanel o Syspanel (antes conocido como HestiaCP). Recuerda que si usas Syspanel, el puerto de acceso es el 2106.

Por ejemplo, si tu dominio es tudominio.com, la URL para acceder a Syspanel sería: https://tudominio.com:2106

Una vez dentro, busca la sección de Bases de Datos o MySQL Databases.

Paso 3: Comprueba los datos en el archivo wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene el nombre de la base de datos, el usuario, la contraseña y el servidor. Si alguno de estos datos es incorrecto, aparecerá el error conexión base datos WordPress.

¿Cómo localizar y editar el archivo?

Desde el panel de control, usa el Administrador de Archivos (File Manager).
Navega hasta la carpeta raíz de tu sitio (normalmente public_html o www).
Busca el archivo wp-config.php. Si no lo ves, asegúrate de mostrar archivos ocultos.
Haz clic derecho sobre él y selecciona Editar o View/Edit.

¿Qué datos debes revisar?

Dentro del archivo, busca estas líneas:

define('DB_NAME', 'nombre_base_datos');
define('DB_USER', 'usuario_base_datos');
define('DB_PASSWORD', 'contraseña_base_datos');
define('DB_HOST', 'localhost');

DB_NAME: El nombre exacto de tu base de datos (suele incluir el prefijo de tu usuario de hosting).
DB_USER: El usuario que tiene permiso para acceder a esa base de datos.
DB_PASSWORD: La contraseña de ese usuario.
DB_HOST: Normalmente es localhost, pero algunos hostings usan algo como mysql.tudominio.com o una IP.

[WARNING] Si cambias estos datos, asegúrate de que coincidan exactamente con los que aparecen en la sección de Bases de Datos de tu panel. Un simple error tipográfico puede causar el fallo.

Paso 4: Verifica los datos desde el panel de control

Para estar seguro de que los datos son correctos:

En tu panel (cPanel o Syspanel), ve a la sección Bases de Datos MySQL.
Busca la lista de bases de datos y usuarios.
Anota el nombre exacto de la base de datos y el usuario asociado.
Si no recuerdas la contraseña, puedes cambiarla desde el panel (opción Change Password).
Una vez que tengas los datos correctos, actualiza el archivo wp-config.php con ellos.

[INFO] Si cambias la contraseña de la base de datos, recuerda actualizarla también en el archivo wp-config.php. De lo contrario, seguirás viendo el error.

Paso 5: Repara la base de datos dañada

A veces la base de datos se corrompe por cortes de energía, errores del servidor o malas prácticas. WordPress incluye una herramienta de reparación.

¿Cómo activarla?

Abre tu archivo wp-config.php con el editor.
Busca la línea que dice define('WP_DEBUG', false); o similar.
Justo encima de esa línea, agrega esta línea:

define('WP_ALLOW_REPAIR', true);

Guarda los cambios.
Ahora visita esta URL en tu navegador: https://tudominio.com/wp-admin/maint/repair.php

Se abrirá una página con dos opciones:

Repair Database: Intenta reparar los errores.
Repair and Optimize Database: Además de reparar, optimiza las tablas.

Haz clic en Repair Database y espera a que termine.
Una vez finalizado, vuelve a tu archivo wp-config.php y elimina la línea que agregaste (la de WP_ALLOW_REPAIR). Dejarla activa es un riesgo de seguridad.

[WARNING] No olvides borrar esa línea después de la reparación, o cualquier persona podría intentar reparar tu base de datos.

Paso 6: Comprueba el estado del servidor de base de datos

Si los pasos anteriores no funcionan, el problema puede estar en el servidor. Contacta a tu proveedor de hosting o, si tienes acceso a Syspanel, puedes revisar el estado de los servicios.

En Syspanel (puerto 2106):

Accede a tu panel.
Busca la sección Server o Services.
Verifica que MySQL o MariaDB esté en verde (activo). Si está rojo, intenta reiniciarlo desde el mismo panel.

[TIP] Si no sabes cómo hacerlo, pide ayuda al soporte técnico de tu hosting. Ellos pueden reiniciar el servicio de base de datos en segundos.

Paso 7: Desactiva plugins y temas (si puedes acceder al admin)

A veces un plugin o tema defectuoso causa el WordPress database error. Si aún puedes acceder al área de administración (aunque la web pública falle), prueba esto:

Ve a Plugins y desactiva todos.
Si el error desaparece, reactívalos uno por uno hasta encontrar el culpable.
Si no puedes acceder al admin, renombra la carpeta wp-content/plugins desde el Administrador de Archivos. Por ejemplo, cámbiala a plugins_old. Esto desactivará todos los plugins automáticamente.
También puedes renombrar la carpeta del tema activo (dentro de wp-content/themes) para forzar un tema por defecto.

Paso 8: Verifica los permisos de la base de datos

En tu panel de control, asegúrate de que el usuario de la base de datos tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.). En cPanel o Syspanel, suele haber una opción para asignar privilegios.

Ve a la sección de Bases de Datos MySQL.
Busca el usuario asociado a tu base de datos.
Haz clic en Manage User Privileges o similar.
Marca todas las casillas y guarda.

Paso 9: Restaura una copia de seguridad

Si nada funciona y tienes una copia de seguridad reciente, restáurala. Esto te devolverá a un estado anterior donde el sitio funcionaba correctamente.

[INFO] La mayoría de los hostings ofrecen copias de seguridad automáticas. En Syspanel, puedes encontrar la opción Backup en el panel principal. Si no, contacta al soporte.

Preguntas Frecuentes (FAQ)

¿Por qué aparece "Error de conexión a la base de datos" después de mover mi sitio?

Es muy común. Al migrar, los datos de conexión cambian. Debes actualizar el archivo wp-config.php con los nuevos valores de tu nuevo hosting.

¿Puedo solucionar este error sin acceso al panel de control?

Si no tienes acceso al panel, contacta al soporte de tu hosting. Ellos pueden verificar los datos de conexión y reiniciar servicios por ti.

¿El error puede deberse a un ataque de hackers?

Sí, aunque es menos común. Si sospechas de un ataque, cambia todas las contraseñas (base de datos, FTP, WordPress) y restaura una copia limpia.

¿Qué hago si el archivo wp-config.php no existe?

Si no encuentras el archivo, es posible que tu instalación esté dañada. Puedes descargar una copia nueva de WordPress y extraer el archivo wp-config-sample.php, renombrarlo a wp-config.php y completar los datos de conexión.

¿El error "WordPress no conecta base datos" afecta a todo el sitio o solo al panel de administración?

Generalmente afecta a todo el sitio. No podrás ver ni la página principal ni el área de administración.

Conclusión

El error conexión base datos WordPress puede ser frustrante, pero siguiendo estos pasos podrás resolverlo en la mayoría de los casos. Recuerda siempre empezar por lo más simple: verificar los datos en el archivo wp-config.php y comprobar que la base de datos no esté dañada. Si después de todo el problema persiste, tu hosting es tu mejor aliado: su soporte técnico puede ayudarte a diagnosticar problemas en el servidor.

[TIP] Para evitar futuros sustos, programa copias de seguridad automáticas y mantén un registro de los datos de conexión de tu base de datos. Así, si el error vuelve a aparecer, podrás solucionarlo en minutos.

Espero que esta guía te haya sido de ayuda. ¡Tu sitio web estará online de nuevo en poco tiempo!