Solucionar error de conexión a base de datos en WordPress | SysAdmin

¡Hola! Soy tu técnico de soporte amigable. Entiendo lo frustrante que es ver ese mensaje de "Error al establecer una conexión con 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 lo hiciéramos juntos.

Este artículo está diseñado para que, incluso si no eres un experto en sistemas, puedas seguir las instrucciones sin problemas. Actuaremos como un sysadmin WordPress, pero con un lenguaje claro y humano. Empecemos.

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

Cuando ves el mensaje error conexión base de datos WordPress, significa que tu sitio web (los archivos de WordPress) no puede comunicarse con el servidor donde se almacena toda tu información (posts, páginas, usuarios, comentarios, etc.). Es como si tu casa (WordPress) perdiera la llave de su archivo central (la base de datos).

Las causas más frecuentes suelen ser:

Credenciales incorrectas: El usuario, la contraseña, el nombre de la base de datos o el servidor (host) están mal escritos en el archivo de configuración de WordPress.
Servidor de base de datos caído o sobrecargado: A veces, el servicio MySQL o MariaDB se detiene por un error interno o porque el servidor tiene demasiado trabajo.
Corrupción de la base de datos: Una actualización fallida, un plugin conflictivo o un corte de energía pueden dañar las tablas de la base de datos.
Problemas de permisos: El usuario de la base de datos no tiene los permisos correctos para leer o escribir en ella.
Cambios en el hosting: Si has movido tu web de servidor o has cambiado de proveedor, es posible que los datos de conexión hayan cambiado.

No te alarmes. Vamos a diagnosticar y solucionar cada una de estas posibilidades. Te prometo que, en la mayoría de los casos, el problema se resuelve en pocos minutos.

Paso 1: Verifica tus credenciales en el archivo wp-config.php

Este es el primer lugar donde debemos mirar. El archivo wp-config.php es el corazón de la configuración de WordPress y contiene los datos de acceso a la base de datos. Un simple error tipográfico aquí provoca el WordPress error base de datos.

¿Cómo acceder al archivo?

Necesitas un cliente FTP (como FileZilla) o el administrador de archivos de tu panel de hosting.

Conéctate a tu servidor mediante FTP o abre el administrador de archivos.
Navega hasta la carpeta raíz de tu instalación de WordPress (normalmente se llama public_html, htdocs o el nombre de tu dominio).
Busca el archivo wp-config.php. Si no lo ves, asegúrate de que estás viendo archivos ocultos (en FileZilla, ve a "Servidor" -> "Forzar mostrar archivos ocultos").

¿Qué debo buscar y corregir?

Abre el archivo con un editor de texto (como Notepad++ o el editor del panel). Busca estas líneas:

define('DB_NAME', 'nombre_de_tu_bd');
define('DB_USER', 'usuario_de_tu_bd');
define('DB_PASSWORD', 'contraseña_de_tu_bd');
define('DB_HOST', 'localhost');

DB_NAME: Debe coincidir exactamente con el nombre de tu base de datos.
DB_USER: Debe coincidir con el usuario de la base de datos.
DB_PASSWORD: Asegúrate de que la contraseña sea la correcta. A veces, al copiar y pegar se añaden espacios.
DB_HOST: Lo más común es localhost, pero algunos hosts usan direcciones como mysql.servidor.com o 127.0.0.1.

[TIP]: Si no recuerdas tus credenciales, puedes encontrarlas en el panel de control de tu hosting (cPanel, Syspanel, Plesk, etc.). Si usas Syspanel (antes conocido como HestiaCP), accede por el puerto 2106 (ejemplo: https://tudominio.com:2106) y busca la sección de "Bases de Datos". Allí verás el nombre de la BD, el usuario y podrás cambiar la contraseña.

Si todo parece correcto, pasa al siguiente paso. Si cambiaste algo, ¡guarda el archivo y recarga tu web!

Paso 2: Revisa el estado del servidor de base de datos

A veces, el problema no está en WordPress, sino en el propio servicio de base de datos. Si el servidor MySQL o MariaDB está detenido, tu web no podrá conectar.

Si tienes acceso a Syspanel (o un panel similar)

Accede a Syspanel a través del puerto 2106.
Ve a la sección "Servicios" o "Estado del servidor".
Busca "MySQL" o "MariaDB". Debería aparecer como "En ejecución" o "Running".
Si está detenido, haz clic en el botón de "Iniciar" o "Reiniciar".

Si tienes acceso por SSH (línea de comandos)

Si te sientes más cómodo con la terminal, puedes ejecutar estos comandos:

# Para sistemas con systemd (Ubuntu, Debian, CentOS 7+)
sudo systemctl status mysql
# o
sudo systemctl status mariadb

# Si está detenido, inícialo:
sudo systemctl start mysql
# o
sudo systemctl start mariadb

# Para que se inicie automáticamente al arrancar el servidor:
sudo systemctl enable mysql

[WARNING]: Si el servicio se detiene constantemente, puede ser un problema de recursos del servidor (poca memoria RAM) o una configuración incorrecta. En ese caso, contacta a tu proveedor de hosting.

Paso 3: Reparar la base de datos de WordPress

Si las credenciales son correctas y el servidor está funcionando, pero el error persiste, es muy probable que la base de datos esté corrupta. WordPress tiene una herramienta interna para reparar base de datos muy sencilla de usar.

Activando el modo de reparación

Conecta por FTP o al administrador de archivos.
Abre el archivo wp-config.php.
Justo antes de la línea que dice /* ¡Eso es todo, deja de editar! Feliz blogging. */, añade esta línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
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 con dos opciones:
- "Reparar base de datos": Solo repara los problemas.
- "Reparar y optimizar base de datos": Repara y además optimiza las tablas (la recomiendo).
Haz clic en el botón correspondiente. El proceso puede tardar unos segundos.
IMPORTANTE: Una vez terminado, vuelve a wp-config.php y elimina la línea que añadiste. Si la dejas, cualquiera podría acceder a la herramienta de reparación.

[INFO]: Esta herramienta es segura y no borra datos. Solo intenta arreglar las tablas dañadas. Es una de las primeras cosas que haría un sysadmin WordPress experimentado.

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

A veces, el usuario tiene todos los datos correctos, pero no tiene permisos suficientes para acceder a la base de datos desde el servidor web.

Cómo comprobarlo en Syspanel

Accede a Syspanel (puerto 2106).
Ve a "Bases de Datos".
Busca tu base de datos y haz clic en "Editar" o "Gestionar".
Asegúrate de que el usuario vinculado tiene marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc.). Lo más seguro es marcar "Todos los privilegios".
Guarda los cambios.

Cómo comprobarlo desde phpMyAdmin

Si tu panel tiene phpMyAdmin (una herramienta web para gestionar bases de datos):

Entra a phpMyAdmin.
Selecciona tu base de datos en la columna de la izquierda.
Haz clic en la pestaña "Privilegios".
Busca tu usuario y haz clic en "Editar privilegios".
Marca "Seleccionar todo" y luego "Ejecutar".

Paso 5: Revisa el archivo .htaccess (solución avanzada)

En raras ocasiones, un plugin de seguridad o caché puede modificar el archivo .htaccess y bloquear la conexión. Vamos a descartarlo.

Conéctate por FTP.
Busca el archivo .htaccess en la raíz de WordPress. Si no lo ves, asegúrate de mostrar archivos ocultos.
Renombra el archivo a .htaccess_old (esto lo desactivará temporalmente).
Recarga tu web. Si funciona, el problema estaba ahí.
Para regenerar un .htaccess limpio, ve a Ajustes -> Enlaces permanentes en tu panel de WordPress y haz clic en "Guardar cambios" (aunque no cambies nada). Esto creará un nuevo archivo.

Preguntas Frecuentes (FAQ)

¿Por qué veo este error después de mover mi web a un nuevo hosting?

Es muy común. Al migrar, las credenciales de la base de datos cambian. Debes actualizar el archivo wp-config.php con los nuevos datos de tu nuevo hosting. También asegúrate de que la base de datos y el usuario se hayan creado correctamente en el nuevo servidor.

¿Puedo perder mis datos si reparo la base de datos?

No. La herramienta de reparación de WordPress solo intenta arreglar las tablas dañadas. No elimina contenido. Sin embargo, siempre es buena práctica tener una copia de seguridad antes de hacer cualquier modificación importante.

¿Qué hago si nada de esto funciona?

Si has seguido todos los pasos y el error persiste, el problema puede ser más profundo: un fallo en el disco duro del servidor, un problema de red interna o una configuración de firewall. Te recomiendo:

Contactar a tu proveedor de hosting directamente. Ellos pueden ver los logs del servidor y detectar el problema.
Restaurar una copia de seguridad reciente de tu web (archivos y base de datos).
Revisar los logs de errores de PHP en tu servidor. A menudo contienen pistas específicas.

¿El plugin "W3 Total Cache" o "WP Super Cache" puede causar este error?

Sí, aunque es raro. A veces, estos plugins generan archivos de caché corruptos. Si el error apareció justo después de instalar o actualizar un plugin de caché, desactívalo renombrando su carpeta desde FTP (por ejemplo, de /wp-content/plugins/w3-total-cache a /wp-content/plugins/w3-total-cache_desactivado).

Resumen final para sysadmins y usuarios

Para solucionar error WordPress de conexión a la base de datos, el orden de actuación es:

Verifica wp-config.php (credenciales).
Reinicia el servicio MySQL/MariaDB desde el panel o SSH.
Usa la herramienta de reparación (wp-admin/maint/repair.php).
Revisa los permisos del usuario de la base de datos.
Renombra .htaccess para descartar conflictos.
Contacta al soporte técnico si nada funciona.

Recuerda, la paciencia es clave. Este error, aunque alarmante, rara vez es catastrófico. Siguiendo estos pasos, en la mayoría de los casos, tu web volverá a la vida en pocos minutos. ¡Ánimo y a seguir creando contenido!

[TIP FINAL]: Para evitar futuros sustos, programa copias de seguridad automáticas de tu base de datos y archivos. Muchos paneles como Syspanel ofrecen esta función. ¡La prevención es la mejor herramienta de un buen sysadmin WordPress!