Solucionar error de conexión a base de datos en WordPress | Guía 2024

¿Te ha aparecido el temido mensaje "Error al conectar con la base de datos" en tu sitio WordPress? No te preocupes, es uno de los errores más comunes y, por suerte, suele tener solución en pocos minutos. Este aviso significa que WordPress no puede comunicarse con la base de datos donde se almacenan tus artículos, usuarios, comentarios y configuraciones.

En esta guía extensa y paso a paso, te explicaré las causas más frecuentes y cómo solucionar el error WordPress de conexión a la base de datos. No necesitas ser un experto técnico; solo sigue las instrucciones con calma y en orden.

¿Por qué aparece este error de base de datos?

Antes de lanzarnos a arreglarlo, es útil entender qué lo provoca. La base de datos es el corazón de WordPress. Sin ella, tu web no puede cargar nada. Las causas principales son:

Credenciales incorrectas en el archivo wp-config.php.
El servidor de base de datos está caído o sobrecargado (problema del hosting).
Corrupción de la base de datos (tablas dañadas).
Problemas de permisos del usuario de la base de datos.
Un plugin o tema recién instalado que ha roto la conexión.
Cambios recientes en tu panel de control (como cambiar la contraseña de la base de datos).

Vamos a atacar cada posible causa desde la más simple a la más compleja.

Paso 1: Verifica que el servidor de base de datos esté funcionando

A veces el problema no es tuyo, sino del servidor. Si tu web usa un hosting compartido, es posible que el servicio MySQL (o MariaDB) se haya reiniciado o esté saturado.

¿Cómo comprobarlo?

Accede a tu panel de control de hosting. Si usas Syspanel (el antiguo HestiaCP), recuerda que la URL de acceso suele ser https://tudominio.com:2106 o la IP de tu servidor seguida de :2106.
Busca la sección de Base de Datos o Servicios del Sistema.
Verifica que el servicio MySQL o MariaDB esté marcado como "Activo" o "Running". Si está apagado, puedes reiniciarlo desde el mismo panel.

[TIP] Si no tienes acceso al panel o no ves la opción, contacta con el soporte técnico de tu hosting. Ellos pueden reiniciar el servicio en segundos.

Paso 2: Revisa y corrige el archivo `wp-config.php`

El archivo wp-config.php es el que contiene las credenciales de acceso a tu base de datos. Un error aquí es la causa más habitual del error base de datos.

¿Cómo acceder al archivo?

Opción A (recomendada para principiantes): Usa el administrador de archivos de tu panel de hosting (Syspanel, cPanel, etc.). Busca la carpeta raíz de tu web (normalmente public_html o www) y localiza el archivo wp-config.php.
Opción B: Conéctate por FTP (FileZilla, Cyberduck) y navega hasta la raíz de tu sitio.

¿Qué debes revisar exactamente?

Abre el archivo con un editor de texto (Bloc de notas, Sublime Text, etc.) y busca las siguientes líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_la_base');
define('DB_PASSWORD', 'contraseña_secreta');
define('DB_HOST', 'localhost');

Verifica estos puntos:

DB_NAME: Debe coincidir exactamente con el nombre de tu base de datos (puedes verlo en tu panel de Syspanel > Base de Datos).
DB_USER: El usuario debe tener acceso a esa base de datos.
DB_PASSWORD: La contraseña debe ser la correcta. Si la cambiaste recientemente, actualízala aquí.
DB_HOST: En la mayoría de los casos es localhost. Sin embargo, algunos hosts usan direcciones como mysql.tudominio.com o 127.0.0.1. Si no estás seguro, consulta la documentación de tu hosting.

[WARNING] Ten mucho cuidado al editar este archivo. No borres ninguna línea ni añadas espacios extra. Si cometes un error, WordPress no podrá conectarse. Guarda una copia de seguridad antes de modificar nada.

¿Cómo obtener las credenciales correctas?

Si no recuerdas los datos, puedes:

Desde Syspanel: Ve a Base de Datos y busca la base de datos asociada a tu WordPress. Ahí verás el nombre, el usuario y tendrás la opción de cambiar la contraseña (si lo haces, actualiza también el wp-config.php).
Desde phpMyAdmin: Si tienes acceso a phpMyAdmin (desde tu panel), puedes ver las bases de datos y los usuarios.

Paso 3: Repara la base de datos (si está corrupta)

A veces la base de datos se corrompe por un corte de energía, un error al actualizar WordPress o un plugin conflictivo. WordPress tiene una función de reparación automática.

Cómo activar la reparación:

Vuelve a abrir tu archivo wp-config.php.
Busca la línea que dice define('WP_DEBUG', false); (o similar).
Justo antes de esa línea, añade esta nueva línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y súbelo de nuevo al servidor.
Ahora, en tu navegador, visita esta URL (reemplaza tudominio.com por tu dominio real):

https://tudominio.com/wp-admin/maint/repair.php

Verás una pantalla azul con dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Haz clic en la primera.
El proceso puede tardar unos segundos. Al finalizar, verás un mensaje de éxito o errores específicos.

[INFO] Una vez terminada la reparación, vuelve a tu wp-config.php y elimina la línea que añadiste (define('WP_ALLOW_REPAIR', true);). Si la dejas, cualquiera podría ejecutar la reparación sin contraseña.

Paso 4: Verifica los permisos del usuario de la base de datos

A veces el usuario tiene todos los permisos, pero en ocasiones se revocan por error. Si tienes acceso a phpMyAdmin o a la gestión de bases de datos de tu panel:

Entra a la herramienta de gestión de bases de datos (por ejemplo, desde Syspanel: Base de Datos > phpMyAdmin).
Selecciona tu base de datos de WordPress.
Busca la opción de Privilegios o Usuarios.
Asegúrate de que el usuario que usa WordPress tenga marcados al menos estos permisos:
- SELECT
- INSERT
- UPDATE
- DELETE
- CREATE
- ALTER
- INDEX
- DROP

[TIP] Si no estás seguro, simplemente selecciona "Marcar todos" y guarda los cambios. Esto no debería causar problemas de seguridad si es tu único sitio.

Paso 5: Desactiva plugins y temas (sin acceso al panel)

Si el error apareció justo después de instalar un plugin o tema, es probable que sea el culpable. Pero como no puedes acceder al panel de administración, tendrás que desactivarlos manualmente.

Desactivar plugins desde FTP o administrador de archivos:

Conéctate a tu servidor vía FTP o usa el administrador de archivos de tu panel.
Navega a la carpeta wp-content.
Renombra la carpeta plugins a plugins_old (por ejemplo). Esto desactivará todos los plugins de golpe.
Vuelve a cargar tu web. Si el error desaparece, el problema era un plugin.
Para identificar cuál, renombra la carpeta de nuevo a plugins y luego, desde el panel de administración (si ya puedes acceder), ve activándolos uno por uno hasta encontrar el conflictivo.

Desactivar el tema activo:

En la misma carpeta wp-content, busca la carpeta themes.
Dentro, identifica el tema que estás usando (normalmente el que tiene el nombre que recuerdas).
Renombra esa carpeta (por ejemplo, añadiendo _old al final).
WordPress cargará automáticamente un tema por defecto (Twenty Twenty-Four o similar). Si el error se soluciona, el tema era el problema.

Paso 6: Comprueba la dirección del servidor de base de datos (DB_HOST)

Aunque la mayoría de los hosts usan localhost, algunos proveedores (especialmente los que usan servidores separados para la base de datos) requieren una dirección específica.

Syspanel normalmente usa localhost para instalaciones estándar. Pero si tienes un VPS o servidor dedicado, puede que necesites la IP interna del servidor de base de datos.
Hostings compartidos a veces usan algo como mysql.tudominio.com o localhost:/tmp/mysql5.sock.

[WARNING] Si cambias DB_HOST sin saber lo que haces, puedes empeorar el problema. Si no estás seguro, pregunta al soporte técnico de tu hosting cuál es el valor correcto.

Paso 7: Restaura una copia de seguridad

Si has probado todo lo anterior y el error persiste, es posible que la base de datos esté dañada de forma irreversible o que haya un problema de configuración más profundo. En ese caso, restaurar una copia de seguridad reciente es la solución más rápida.

¿Cómo restaurar?

Desde Syspanel: Ve a Backup y busca la copia más reciente de tu base de datos. Selecciona Restaurar.
Desde phpMyAdmin: Si tienes un archivo .sql de respaldo, puedes importarlo desde la pestaña Importar.
Desde un plugin de backup: Si usabas UpdraftPlus, BackupBuddy, etc., y tienes el archivo de respaldo, puedes subirlo manualmente.

[INFO] Antes de restaurar, asegúrate de haber hecho una copia de la base de datos actual (aunque esté dañada) por si necesitas recuperar algún dato más adelante.

Preguntas frecuentes (FAQ) sobre el error de conexión a la base de datos

¿Puedo perder datos si reparo la base de datos?

No, la reparación solo corrige índices y tablas dañadas. No borra contenido. Sin embargo, es buena práctica tener una copia de seguridad antes de hacer cualquier modificación.

¿El error puede deberse a un ataque de hackers?

Sí, aunque es menos común. Si un hacker ha modificado tu wp-config.php o ha bloqueado el acceso a la base de datos, podrías ver este error. En ese caso, además de reparar la conexión, deberías cambiar todas las contraseñas y escanear tu sitio en busca de malware.

¿Qué hago si el error aparece solo a veces (intermitente)?

Esto suele indicar que el servidor de base de datos está sobrecargado. Contacta con tu hosting y pídeles que revisen el rendimiento de MySQL. También puede deberse a un plugin que hace consultas muy pesadas.

¿Necesito conocimientos de programación para arreglarlo?

No, los pasos que te he dado son muy visuales y no requieren código avanzado. Solo necesitas saber usar un administrador de archivos o FTP, y seguir las instrucciones al pie de la letra.

Conclusión: No entres en pánico, todo tiene solución

El error WordPress de conexión a la base de datos puede ser frustrante, pero como has visto, casi siempre se resuelve revisando las credenciales en wp-config.php, reparando la base de datos o desactivando plugins conflictivos. Recuerda siempre trabajar con calma, hacer copias de seguridad antes de cualquier cambio y, si te bloqueas, pedir ayuda al soporte técnico de tu hosting (especialmente si usas Syspanel, donde el acceso es por el puerto 2106).

Ahora ya tienes todas las herramientas para solucionar el error WordPress y volver a tener tu web online en pocos minutos. ¡Manos a la obra!