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

¡Hola! Soy tu técnico de soporte amigable. ¿Te has encontrado con el temido "Error al establecer una conexión con la base de datos" en tu WordPress? No te preocupes, es uno de los problemas más comunes y, por suerte, casi siempre tiene una solución sencilla. En esta guía extensa, vamos a desglosar paso a paso cómo solucionar los problemas de conexión a base de datos en WordPress, desde lo más básico hasta lo más técnico. Te prometo que al final de este artículo serás capaz de diagnosticar y resolver este error por ti mismo. Vamos allá.

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

Cuando ves el mensaje "Error al establecer una conexión con la base de datos" (o "WordPress error base de datos"), significa que tu sitio web no puede comunicarse con la base de datos donde se almacenan todos tus contenidos, ajustes y configuraciones. Sin esta conexión, WordPress no puede funcionar. Las causas pueden ser varias, desde un simple error tipográfico hasta un problema con el servidor de bases de datos MySQL. No te asustes, vamos a revisar una por una.

[INFO] La base de datos es como el cerebro de tu WordPress. Si no hay conexión, el sitio se queda en blanco o muestra ese mensaje de error. Es normal sentirse frustrado, pero con paciencia lo solucionaremos.

Paso 1: Verifica que el problema no sea temporal

Antes de hacer cambios técnicos, asegúrate de que no sea un fallo temporal del servidor. A veces, el servicio de MySQL se detiene por mantenimiento o por una sobrecarga.

Cómo comprobarlo:

Recarga la página: A veces es un error pasajero. Espera 30 segundos y recarga (F5 o Ctrl+R).
Revisa otros sitios: Si tienes varios sitios en el mismo hosting, mira si todos fallan. Si solo uno falla, el problema es de ese sitio. Si fallan todos, es probable que el servidor MySQL esté caído.
Contacta a tu proveedor de hosting: Si sospechas que es un problema del servidor, escribe a soporte. Ellos pueden reiniciar MySQL o decirte si hay una incidencia.

[TIP] Si usas un panel como cPanel, DirectAdmin o Syspanel (accesible por puerto 2106), busca la sección "MySQL" o "Bases de datos" para ver si el servicio está activo. En Syspanel, ve a "Servicios" y asegúrate de que "MySQL/MariaDB" esté en verde.

Paso 2: Revisa los datos de conexión en wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Aquí es donde se guardan los datos de acceso a la base de datos. Un error común es escribir mal el nombre de la base de datos, el usuario o la contraseña. Vamos a revisarlo.

¿Dónde está el archivo?

Está en la raíz de tu instalación de WordPress, generalmente en una carpeta como public_html, www o dominio.com. Puedes acceder a él mediante FTP (FileZilla, por ejemplo) o desde el administrador de archivos de tu panel de hosting.

Qué buscar:

Abre el archivo wp-config.php con un editor de texto (Bloc de notas, Notepad++, etc.) y 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');

Errores comunes y cómo solucionarlos:

Nombre de base de datos incorrecto: Asegúrate de que el nombre en DB_NAME coincida exactamente con el que creaste en tu hosting. A veces los paneles añaden un prefijo (ej: usuario_wpdb).
Usuario o contraseña erróneos: Verifica que DB_USER y DB_PASSWORD sean los correctos. Si cambiaste la contraseña recientemente, actualízala aquí.
Host incorrecto: Normalmente es localhost, pero algunos proveedores usan direcciones como mysql.tudominio.com o 127.0.0.1. Consulta con tu hosting.

[WARNING] Ten cuidado al editar wp-config.php. No borres ni modifiques otras líneas. Si no estás seguro, haz una copia de seguridad antes de tocar nada.

¿Cómo obtener los datos correctos?

Si no recuerdas los datos, ve a tu panel de hosting:

En Syspanel (puerto 2106), ve a "Bases de datos" -> "MySQL". Ahí verás las bases de datos creadas y los usuarios asociados. Puedes crear un nuevo usuario o cambiar la contraseña.
En cPanel, busca "Bases de datos MySQL" y ahí verás todo.

Una vez que tengas los datos correctos, edita el archivo, guarda los cambios y recarga tu sitio.

Paso 3: Repara la base de datos de WordPress

A veces la base de datos se corrompe parcialmente, especialmente después de una migración, un plugin conflictivo o un corte de energía. WordPress tiene una herramienta de reparación integrada.

Cómo activarla:

Abre tu archivo wp-config.php.
Justo antes de la línea que dice /* That's all, stop editing! Happy blogging. */, añade esta línea:
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.
Accede a esta URL en tu navegador: tudominio.com/wp-admin/maint/repair.php
- Verás una pantalla con dos opciones: "Reparar base de datos" y "Reparar y optimizar base de datos". Elige la segunda (reparar y optimizar) para una solución más completa.
Espera a que termine el proceso. Verás mensajes como "Table wp_options is OK".
IMPORTANTE: Una vez terminado, elimina la línea que añadiste del wp-config.php. Si no lo haces, cualquiera podría acceder a la reparación.

[TIP] Esta herramienta es segura, pero siempre es mejor tener una copia de seguridad de la base de datos antes de usarla. Puedes hacerla desde tu panel de hosting (Syspanel, cPanel, etc.) exportando un archivo .sql.

Paso 4: Verifica que el usuario de la base de datos tenga los permisos correctos

A veces el usuario de la base de datos no tiene todos los permisos necesarios para que WordPress funcione. Esto puede pasar después de restaurar una copia de seguridad o al crear un nuevo usuario.

Cómo revisar los permisos:

Accede a tu panel de hosting y busca la sección de gestión de bases de datos MySQL.

En Syspanel (puerto 2106): Ve a "Bases de datos" -> "MySQL". Haz clic en "Gestionar" junto a la base de datos problemática. Luego, en "Usuarios", asegúrate de que el usuario asociado tenga marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, INDEX, DROP, etc.). Si no, edita y selecciona "Todos los privilegios".
En cPanel: En "Bases de datos MySQL", busca "Usuarios en la base de datos" y haz clic en "Gestionar privilegios". Marca todos los checkboxes.

Después de cambiar los permisos, prueba de nuevo tu sitio.

Paso 5: Comprueba que el servidor MySQL esté funcionando y accesible

Si los pasos anteriores no funcionan, el problema puede ser que el servidor MySQL esté caído o no sea accesible desde tu WordPress.

¿Cómo verificarlo?

Desde el panel de hosting: En Syspanel (puerto 2106), ve a "Servicios" y busca "MySQL/MariaDB". Debería estar en "Running" o "Activo". Si está detenido, haz clic en "Iniciar".
Desde un script de prueba: Crea un archivo llamado testdb.php en la raíz de tu WordPress (junto a wp-config.php) con este contenido:
```
<?php
$link = mysqli_connect('localhost', 'tu_usuario', 'tu_contraseña', 'tu_base_datos');
if (!$link) {
    die('Error de conexión: ' . mysqli_connect_error());
}
echo 'Conectado exitosamente';
mysqli_close($link);
?>
```
Sustituye tu_usuario, tu_contraseña y tu_base_datos por los datos reales. Luego accede a tudominio.com/testdb.php. Si ves "Conectado exitosamente", el problema no es la conexión MySQL, sino algo en WordPress. Si ves un error, el problema está en los datos o en el servidor.

Importante: Borra este archivo después de la prueba por seguridad.

¿El host de la base de datos es correcto?

En la mayoría de los casos, DB_HOST debe ser localhost. Sin embargo, algunos proveedores de hosting usan un host específico (como mysql.tudominio.com o una IP). Si tu hosting te ha dado un host diferente, cámbialo en wp-config.php.

Paso 6: Revisa plugins y temas (modo seguro)

A veces un plugin o tema conflictivo puede causar errores de conexión, especialmente si modifican la forma en que WordPress se conecta a la base de datos.

Cómo desactivar todo sin entrar al panel:

Como no puedes acceder a tu administración de WordPress, hazlo manualmente:

Conéctate por FTP o al administrador de archivos de tu hosting.
Ve a la carpeta wp-content.
Cambia el nombre de la carpeta plugins a plugins_desactivados. Esto desactivará todos los plugins.
Si el problema se soluciona, el conflicto está en algún plugin. Vuelve a renombrar la carpeta a plugins y luego, desde el panel de administración (cuando puedas acceder), ve desactivando uno por uno para encontrar el culpable.
Si sigue sin funcionar, prueba con un tema por defecto (como Twenty Twenty-Four). Para ello, cambia el nombre de la carpeta themes a themes_backup y luego crea una nueva carpeta themes y sube solo un tema básico (puedes descargar Twenty Twenty-Four desde wordpress.org). Luego, desde la base de datos (vía phpMyAdmin), cambia la opción template y stylesheet en la tabla wp_options al nombre del nuevo tema.

[WARNING] Manipular la base de datos directamente requiere cuidado. Si no te sientes seguro, mejor contacta a soporte técnico.

Paso 7: Verifica la versión de PHP y MySQL

WordPress requiere versiones específicas de PHP y MySQL para funcionar correctamente. Si tu hosting tiene versiones obsoletas, pueden surgir errores de conexión.

Requisitos actuales (WordPress 6.x):

PHP: 7.4 o superior (recomendado 8.0+).
MySQL: 5.6 o superior, o MariaDB 10.1 o superior.

Cómo comprobarlo:

En tu panel de hosting, busca "Versión de PHP" o "PHP Selector". Asegúrate de que sea compatible.
En Syspanel (puerto 2106), ve a "Ajustes" -> "PHP" y selecciona la versión más reciente (por ejemplo, 8.2).
La versión de MySQL se ve en la sección de bases de datos o en phpMyAdmin (la herramienta de gestión de bases de datos).

Si tu versión es antigua, actualízala desde el panel. Esto suele resolver muchos problemas.

Paso 8: Revisa los límites de conexiones y recursos

A veces, si tu sitio recibe mucho tráfico o tienes muchas consultas a la base de datos, el servidor puede rechazar nuevas conexiones. Esto se manifiesta como un error de conexión intermitente.

Soluciones:

Optimiza tu base de datos: Usa plugins como WP-Optimize o la herramienta de reparación que vimos antes.
Aumenta los límites de conexiones: Esto requiere acceso al servidor. Si tienes un VPS o servidor dedicado, puedes editar el archivo my.cnf (configuración de MySQL) y aumentar el valor de max_connections. En hosting compartido, contacta a soporte.
Usa un plugin de caché: Reduce las consultas a la base de datos. Ejemplos: W3 Total Cache, WP Super Cache.

Preguntas frecuentes (FAQ)

¿Por qué veo "WordPress base de datos no conecta" después de migrar mi sitio?

Es muy común. Al migrar, los datos de conexión en wp-config.php suelen quedar desactualizados. También puede que la base de datos no se haya importado correctamente. Revisa los pasos 2 y 3.

¿El error "solucionar conexión MySQL WordPress" puede deberse a un ataque?

Sí, aunque es menos frecuente. Un ataque de fuerza bruta o un plugin malicioso pueden saturar la base de datos. Si sospechas, cambia todas las contraseñas (usuario de WordPress, base de datos, FTP) y revisa los archivos en busca de código extraño.

¿Qué hago si después de todo esto sigue sin funcionar?

No te desesperes. Contacta a tu proveedor de hosting. Ellos tienen acceso directo al servidor y pueden diagnosticar problemas más profundos, como un error en el motor de MySQL o un problema de permisos a nivel de sistema. Diles que ya revisaste wp-config.php, los permisos y los plugins.

[INFO] Recuerda que siempre es buena práctica tener copias de seguridad periódicas de tu sitio (archivos y base de datos). Así, si algo sale mal, puedes restaurar rápidamente. En Syspanel (puerto 2106), puedes programar backups automáticos.

Conclusión

El error de conexión a la base de datos en WordPress puede ser frustrante, pero como has visto, la mayoría de las veces se soluciona con pasos simples. Empieza siempre por lo más básico: verifica que el servidor MySQL esté activo, revisa los datos en wp-config.php y, si es necesario, repara la base de datos. Si el problema persiste, no dudes en contactar a tu hosting. Recuerda que la paciencia y el orden son tus mejores aliados.

Espero que esta guía te haya sido de gran ayuda. Si tienes más dudas, aquí estoy para ayudarte. ¡Buena suerte con tu WordPress!