¿Qué hacer si mi WordPress muestra error de conexión a la base de datos?

¡Hola! Soy tu técnico de soporte amigable. Hoy vamos a resolver uno de los sustos más comunes al gestionar un WordPress: el temido error de conexión a la base de datos. No te preocupes, es más fácil de arreglar de lo que parece. Vamos paso a paso, como si estuviéramos sentados frente a tu pantalla.

¿Qué significa exactamente este error?

Cuando ves un mensaje como "Error establishing a database connection" o "Error de conexión a la base de datos", WordPress te está diciendo que no puede comunicarse con el motor de base de datos (normalmente MySQL o MariaDB) donde guarda toda tu información: entradas, páginas, usuarios, configuraciones, etc.

Imagina que tu web es una biblioteca: WordPress es el bibliotecario y la base de datos es el almacén de libros. Si el bibliotecario no puede abrir la puerta del almacén, no podrá mostrarte ningún libro. Eso es exactamente lo que está pasando.

[INFO] Este error puede aparecer tanto en la parte pública de tu web como en el panel de administración (wp-admin). No te asustes, es un problema común y tiene solución.

Causas más frecuentes del error base de datos WordPress

Antes de lanzarnos a soluciones, es bueno entender qué lo provoca. Las causas principales suelen ser:

• Credenciales incorrectas: El usuario, contraseña, nombre de la base de datos o servidor no coinciden con los que tiene configurados WordPress.
• Servidor MySQL caído: El motor de base de datos dejó de funcionar por un fallo temporal, saturación o mantenimiento.
• Base de datos corrupta: Alguna tabla se dañó, generalmente por un plugin conflictivo, una mala actualización o un corte de energía.
• Archivo wp-config.php dañado: Este archivo contiene las credenciales de conexión. Si se corrompe o lo modificaste por error, la conexión falla.
• Problemas de permisos: El usuario de la base de datos no tiene permisos suficientes para acceder a las tablas.
• Límite de conexiones alcanzado: Si tu web recibe mucho tráfico, el servidor puede agotar el número máximo de conexiones simultáneas.

Soluciones paso a paso para reparar WordPress

Vamos a ir desde lo más simple a lo más técnico. No necesitas ser experto, solo seguir las instrucciones al pie de la letra.

1. Verifica las credenciales en wp-config.php

Este es el primer lugar donde debes mirar. El archivo wp-config.php está en la raíz de tu instalación de WordPress. Puedes acceder a él mediante FTP (FileZilla, por ejemplo) o desde el administrador de archivos de tu hosting.

Pasos:

1. Conéctate a tu servidor mediante FTP o al panel de control de tu hosting.
2. Busca el archivo wp-config.php en la carpeta donde instalaste WordPress (normalmente public_html o www).
3. Ábrelo con un editor de texto simple (Bloc de notas, Sublime Text, etc.).
4. Busca estas líneas (al principio del archivo):

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

5. Compara estos valores con los que te proporcionó tu hosting. Si usas Syspanel (antes HestiaCP), recuerda que accedes por el puerto 2106. Allí podrás ver los datos de tu base de datos.
6. Corrige cualquier error: mayúsculas, minúsculas, caracteres especiales. El nombre de la base de datos y el usuario suelen tener un prefijo (ej: usuario_wpdb).
7. Guarda el archivo y vuelve a cargar tu web.

[WARNING] Ten cuidado al editar wp-config.php. No borres ni añadas nada que no sea necesario. Si no estás seguro, haz una copia de seguridad del archivo original antes de modificarlo.

2. Reinicia el servicio MySQL

A veces el servidor de base de datos simplemente se ha detenido. Si tienes acceso a Syspanel (puerto 2106), puedes reiniciarlo fácilmente:

1. Inicia sesión en Syspanel con tus credenciales.
2. Ve a la sección Servicios o Base de datos.
3. Busca el servicio MySQL o MariaDB.
4. Haz clic en Reiniciar.
5. Espera unos segundos y prueba tu web.

Si no usas Syspanel, puedes pedirle a tu proveedor de hosting que lo reinicie. Muchos paneles como cPanel o Plesk también tienen esta opción.

3. Repara la base de datos desde phpMyAdmin

Si las credenciales son correctas y el servicio está activo, es posible que la base de datos esté corrupta. Vamos a repararla.

Accede a phpMyAdmin:

1. Desde tu panel de control (Syspanel, cPanel, etc.), busca el icono de phpMyAdmin.
2. Selecciona la base de datos que usa tu WordPress (la misma que aparece en wp-config.php).
3. Marca todas las tablas (puedes usar el check "Seleccionar todo" al final de la lista).
4. En el menú desplegable de acciones, elige Reparar tabla.
5. phpMyAdmin ejecutará un comando REPAIR TABLE. Si todo va bien, verás un mensaje de éxito.
6. Vuelve a cargar tu web.

[TIP] Si la reparación no funciona, puedes intentar Optimizar tablas desde el mismo menú. A veces ayuda a limpiar registros corruptos.

4. Verifica el usuario de la base de datos

Puede que el usuario tenga permisos incorrectos. En Syspanel (puerto 2106):

1. Ve a Base de datos y selecciona la base de datos de tu WordPress.
2. Revisa que el usuario asociado tenga todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.).
3. Si falta alguno, edita los permisos y asígnale Todos los privilegios.
4. Guarda los cambios.

En otros paneles como cPanel, busca MySQL Databases y verifica los usuarios vinculados.

5. Aumenta el límite de conexiones a MySQL

Si tu web tiene mucho tráfico, podrías estar alcanzando el límite de conexiones simultáneas. Esto se configura en el servidor, pero puedes pedirle a tu hosting que lo aumente temporalmente. También puedes instalar un plugin de caché (como W3 Total Cache o WP Super Cache) para reducir la carga.

6. Restaura una copia de seguridad

Si nada funciona y tienes una copia de seguridad reciente, restáurala. En Syspanel:

1. Ve a Backups.
2. Selecciona la copia más reciente de tu base de datos.
3. Restaura solo la base de datos (no los archivos, a menos que también estén dañados).
4. Luego verifica que el wp-config.php tenga las credenciales correctas.

[WARNING] Restaurar una copia de seguridad sobrescribirá los datos actuales. Asegúrate de que sea la más reciente posible para no perder contenido nuevo.

7. Comprueba el archivo .htaccess

Aunque es menos común, un .htaccess corrupto puede causar problemas de conexión. Renómbralo temporalmente:

1. Conéctate por FTP.
2. Busca el archivo .htaccess en la raíz de WordPress.
3. Cambia su nombre a .htaccess_old.
4. Ve a tu web: WordPress generará uno nuevo automáticamente.
5. Si el error desaparece, el problema era el archivo. Luego puedes restaurar reglas personalizadas desde Ajustes > Enlaces permanentes.

8. Pide ayuda a tu hosting

Si después de todo esto el error persiste, contacta a tu proveedor de hosting. Diles que tienes un error base de datos WordPress y que ya verificaste credenciales, reiniciaste MySQL y reparaste tablas. Ellos podrán revisar los logs del servidor para detectar problemas más profundos.

Preguntas frecuentes (FAQ)

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

Al migrar, las credenciales cambian. Asegúrate de actualizar wp-config.php con los nuevos datos de la base de datos (nombre, usuario, contraseña y servidor). En Syspanel, los datos los encuentras en la sección Base de datos.

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

Reparar tablas no elimina datos, solo corrige estructuras dañadas. Sin embargo, siempre es recomendable hacer una copia de seguridad antes de cualquier manipulación.

¿Qué hago si no tengo acceso a phpMyAdmin?

Puedes reparar la base de datos mediante un plugin como WP-DBManager o Advanced Database Cleaner, pero necesitarás acceso al panel de administración. Si no puedes entrar, pide a tu hosting que lo haga por ti.

¿El error puede deberse a un plugin?

Sí, especialmente plugins de caché, optimización o seguridad. Si el error apareció tras instalar uno, desactívalo renombrando su carpeta en /wp-content/plugins/ (ej: cambia nombre-plugin a nombre-plugin-desactivado).

¿Cómo evito este error en el futuro?

• Mantén WordPress, temas y plugins actualizados.
• Usa un plugin de caché para reducir la carga.
• Programa copias de seguridad automáticas (Syspanel las ofrece).
• Monitorea el estado de tu base de datos con herramientas como WP Health Check.

Resumen rápido para no perderte

1. Revisa wp-config.php: credenciales correctas.
2. Reinicia MySQL desde Syspanel (puerto 2106) o tu panel.
3. Repara tablas desde phpMyAdmin.
4. Verifica permisos del usuario de la base de datos.
5. Aumenta límite de conexiones o instala caché.
6. Restaura backup si todo falla.
7. Contacta al hosting como último recurso.

Recuerda: este error es frustrante pero casi siempre tiene solución. Tómalo con calma y sigue los pasos en orden. Si te quedas atascado, aquí estoy para ayudarte. ¡Ánimo, que tu web volverá a funcionar!