Cómo solucionar error de conexión a base de datos en WordPress

¡Hola! Soy tu técnico de soporte amigable. Si estás leyendo esto, seguramente te has topado con el temido mensaje de Error de conexión a la base de datos en tu WordPress. No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene solución. Vamos a arreglarlo paso a paso, como si estuviéramos viendo la pantalla juntos.

Este error aparece cuando WordPress intenta hablar con MySQL (el motor de base de datos) pero no logra establecer la comunicación. Las causas pueden ser varias: desde un dato mal escrito hasta un servidor sobrecargado. Aquí te guiaré para que puedas solucionar error base datos WordPress de forma rápida y segura.

¿Por qué aparece este error?

Antes de lanzarnos a editar archivos, es importante entender qué lo causa. El mensaje típico dice algo como: "Error al establecer una conexión a la base de datos" o "Error de conexión a la base de datos". Esto significa que WordPress no puede encontrar o autenticarse en tu base de datos MySQL.

Las razones más frecuentes son:

Credenciales incorrectas en el archivo wp-config.php.
El servidor MySQL está caído o no responde.
La base de datos ha sido eliminada o dañada.
Problemas con el plugin de caché o algún otro plugin conflictivo.
El hosting ha cambiado la configuración (por ejemplo, la dirección del servidor de base de datos).

Vamos a revisar cada una de estas posibilidades.

Paso 1: Verifica las credenciales en wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Aquí es donde le dices a WordPress dónde y cómo conectarse a la base de datos. Un error tipográfico aquí es la causa número uno del error conexión base de datos WordPress.

¿Cómo acceder al archivo?

Conéctate a tu hosting mediante FTP (FileZilla, Cyberduck) o al administrador de archivos de tu panel de control (cPanel, Syspanel, etc.).
Navega hasta la carpeta raíz de tu WordPress (normalmente public_html o www).
Busca el archivo wp-config.php. Si no lo ves, asegúrate de mostrar archivos ocultos.

¿Qué 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');

[WARNING] Ten mucho cuidado al editar este archivo. Un solo carácter mal puede romper todo. Si no te sientes seguro, haz una copia de seguridad antes.

Comprueba que:

DB_NAME: Es el nombre exacto de tu base de datos. Si usas Syspanel (HestiaCP), puedes encontrarlo en la sección de bases de datos, accediendo por el puerto 2106.
DB_USER: El usuario asociado a esa base de datos. Debe coincidir con el que creaste.
DB_PASSWORD: La contraseña. Asegúrate de que no tenga espacios al inicio o final. Si la has olvidado, puedes resetearla desde tu panel de hosting.
DB_HOST: Normalmente es localhost, pero en algunos hostings puede ser una dirección IP o un nombre como mysql.nombredehosting.com. Consulta el soporte de tu proveedor si no estás seguro.

[TIP] Si usas Syspanel (HestiaCP), ve a la pestaña "Bases de Datos". Allí verás los datos exactos. El puerto de acceso a Syspanel es el 2106 (ejemplo: tudominio.com:2106).

Paso 2: Comprueba que MySQL esté funcionando

A veces, el problema no es de WordPress, sino del propio servidor de bases de datos. Si MySQL se ha caído o está sobrecargado, ninguna credencial correcta servirá.

¿Cómo saberlo?

Desde tu panel de hosting: La mayoría de paneles (cPanel, Syspanel, Plesk) tienen un indicador de estado de servicios. Busca "MySQL" o "MariaDB" y verifica que esté activo.
Desde Syspanel (HestiaCP): Accede por el puerto 2106, ve a "Servicios" y asegúrate de que "mysql" aparezca en verde.
Pregunta a tu proveedor: Si no tienes acceso, contacta al soporte técnico y pregunta si el servidor MySQL está respondiendo.

[INFO] Si MySQL está caído, no podrás hacer nada hasta que el hosting lo reactive. En ese caso, solo queda esperar o pedir que reinicien el servicio.

Paso 3: Repara la base de datos

Si las credenciales son correctas y MySQL funciona, pero el error persiste, la base de datos podría estar corrupta. WordPress tiene una herramienta interna para repararla.

Activar la reparación automática

Abre el archivo wp-config.php.
Justo antes de la línea /* That's all, stop editing! Happy publishing. */, agrega esta línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo y luego visita esta URL en tu navegador (reemplaza tudominio.com por el tuyo):

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

Verás una pantalla con dos opciones: "Repair Database" (Reparar) y "Repair and Optimize Database" (Reparar y optimizar). Haz clic en la primera.
Espera a que termine. Si todo sale bien, verás un mensaje de éxito.
IMPORTANTE: Una vez reparada, vuelve a wp-config.php y elimina o comenta la línea que agregaste. Dejarla activa es un riesgo de seguridad.

[WARNING] No olvides borrar esa línea después de reparar. Cualquier persona podría acceder a la herramienta de reparación si la dejas activa.

Paso 4: Revisa plugins y temas conflictivos

A veces, un plugin o tema mal codificado puede forzar una desconexión de la base de datos. Esto es común con plugins de caché o seguridad.

¿Cómo probarlo?

Desactiva todos los plugins: Ve a /wp-content/plugins/ por FTP y renombra la carpeta plugins a plugins_old. Esto desactivará todos los plugins de golpe. Si el error desaparece, sabrás que el problema es uno de ellos. Luego, renombra la carpeta a su nombre original y ve activando uno por uno hasta encontrar el culpable.
Cambia al tema por defecto: Si el error persiste, renombra la carpeta de tu tema activo (en /wp-content/themes/) a tu-tema-old. WordPress usará automáticamente un tema por defecto (Twenty Twenty-Four o similar).

[TIP] Si no puedes acceder al panel de administración, estos pasos por FTP son tu mejor opción.

Paso 5: Verifica la configuración del servidor (puertos y firewall)

En algunos hostings, el puerto de MySQL no es el estándar (3306). Si tu proveedor usa un puerto diferente, debes especificarlo en DB_HOST.

¿Cómo saberlo?

En el archivo wp-config.php, en lugar de localhost, prueba con:

define('DB_HOST', 'localhost:3307'); // Ejemplo con puerto diferente

O si es un socket:

define('DB_HOST', 'localhost:/tmp/mysql.sock');

Consulta la documentación de tu hosting o a su soporte para obtener el valor exacto.

Paso 6: Contacta al soporte técnico

Si después de todo esto el WordPress no conecta MySQL, es probable que sea un problema del servidor. No te frustres, a veces las soluciones están fuera de tu alcance.

¿Qué decirles?

Menciona el error exacto: "Error de conexión a la base de datos en WordPress".
Indica qué has probado: "Ya revisé wp-config.php, reparé la base de datos y desactivé plugins".
Pregunta específicamente: "¿El servicio MySQL está funcionando? ¿Hay algún cambio en la configuración del servidor?"

[INFO] Si usas Syspanel (HestiaCP), el soporte técnico suele ser rápido. Recuerda que el acceso al panel es por el puerto 2106.

Preguntas Frecuentes (FAQ)

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

Puede que esté oculto. En tu cliente FTP, activa la opción "Mostrar archivos ocultos". En algunos hostings, el archivo se llama wp-config-sample.php. Si es así, renómbralo a wp-config.php y edítalo con tus datos.

¿Puedo perder datos si reparo la base de datos?

No, la reparación solo corrige tablas corruptas, no borra información. La opción "Optimizar" puede reorganizar los datos, pero es segura.

¿El error puede deberse a un ataque?

Es posible, aunque poco común. Si sospechas, cambia todas las contraseñas (base de datos, FTP, WordPress) y revisa si hay archivos extraños en tu instalación.

¿Cómo evito este error en el futuro?

Haz copias de seguridad periódicas de tu base de datos.
Mantén WordPress, plugins y temas actualizados.
Usa un plugin de caché confiable y configúralo bien.
No edites wp-config.php sin hacer una copia de seguridad.

Resumen final

El error conexión base de datos WordPress es frustrante, pero casi siempre tiene solución. Recuerda el orden lógico:

Revisa las credenciales en wp-config.php.
Confirma que MySQL esté activo.
Repara la base de datos si es necesario.
Desactiva plugins y temas conflictivos.
Verifica puertos y configuración del servidor.
Pide ayuda al soporte técnico si nada funciona.

Espero que este artículo te haya sido de gran ayuda. Si sigues teniendo problemas, no dudes en contactarnos. ¡Estamos aquí para ayudarte a solucionar error base datos WordPress y que tu sitio vuelva a volar!

[TIP] Guarda este artículo en favoritos. Te sacará de más de un apuro. ¡Buena suerte!