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

¿Qué significa “Error al establecer la conexión con la base de datos”?

Cuando visitas tu sitio WordPress y ves el mensaje “Error al establecer la conexión con la base de datos”, significa que WordPress no puede comunicarse con MySQL o MariaDB, que es donde se guardan tus artículos, páginas, comentarios y configuraciones.

Es uno de los errores más comunes y, aunque puede parecer grave, en la mayoría de los casos tiene una solución sencilla. Este error puede aparecer por varias razones: credenciales incorrectas, el servidor de base de datos caído, archivos corruptos o problemas con el hosting.

A lo largo de esta guía, te explicaré paso a paso cómo diagnosticar y arreglar el error de conexión con la base de datos en WordPress, pensado para que lo entiendas aunque no tengas experiencia técnica avanzada.

Antes de empezar: ¿Qué necesitas?

Para seguir esta guía, necesitarás:

Acceso a tu panel de control de hosting (cPanel, Plesk, Syspanel, etc.).
Credenciales de acceso a tu base de datos (usuario, contraseña, nombre de la base).
Acceso FTP o al administrador de archivos de tu hosting.
En algunos casos, acceso a phpMyAdmin.

[INFO] Si no tienes estos datos a mano, contacta con tu proveedor de hosting. Ellos pueden facilitarte las credenciales o comprobar si hay una caída del servidor.

Paso 1: Verifica si el problema es general o solo tuyo

Antes de tocar nada, comprueba si el error aparece solo en tu sitio o si afecta a otros sitios en el mismo servidor.

Intenta acceder a otros sitios que tengas en el mismo hosting.
Si todos fallan, el problema es del servidor (caída de MySQL, mantenimiento, etc.).
Si solo falla tu WordPress, el problema está en tu instalación o configuración.

[TIP] Puedes usar herramientas como “Is It Down Right Now” para comprobar si tu dominio responde, pero recuerda que este error es interno, así que lo más fiable es probar otros sitios en el mismo hosting.

Paso 2: Revisa las credenciales de la base de datos en wp-config.php

El archivo wp-config.php es el que contiene los datos de conexión a tu base de datos. Si estos datos son incorrectos, WordPress no podrá conectarse.

¿Cómo acceder al archivo wp-config.php?

Desde el panel de control de tu hosting (cPanel, Syspanel, etc.), busca el Administrador de Archivos.
Ve a la carpeta donde está instalado WordPress (normalmente public_html o www).
Busca el archivo wp-config.php.

¿Qué debes comprobar?

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');

DB_NAME: debe coincidir con el nombre real de tu base de datos.
DB_USER: debe ser el usuario asignado a esa base.
DB_PASSWORD: la contraseña exacta (cuidado con espacios o caracteres especiales).
DB_HOST: normalmente es localhost, pero algunos hostings usan direcciones como mysql.tudominio.com o 127.0.0.1.

[WARNING] Si no estás seguro de estos datos, no los inventes. Entra en tu panel de hosting y busca la sección de “Bases de datos MySQL” donde verás el nombre, usuario y podrás cambiar la contraseña.

¿Cómo corregirlo?

Abre el archivo wp-config.php con un editor de texto.
Corrige los valores incorrectos.
Guarda los cambios y recarga tu web.

Si no sabes la contraseña, puedes cambiarla desde el panel de hosting y actualizarla en wp-config.php.

Paso 3: Comprueba que el servidor de base de datos está activo

A veces, el error no es por tus credenciales, sino porque el servidor MySQL está caído o reiniciándose.

¿Cómo comprobarlo?

Accede a tu panel de hosting.
Busca la sección de “Servicios” o “Estado del servidor”.
Si tienes acceso a SSH o terminal, puedes escribir:
```
systemctl status mysql
```
o
```
service mysql status
```
Si el servicio está detenido, puedes iniciarlo con:
```
systemctl start mysql
```
o
```
service mysql start
```

[INFO] En muchos hostings compartidos, no tienes acceso a estos comandos. En ese caso, contacta con soporte y pregunta si el servicio MySQL está operativo.

Paso 4: Revisa si el problema está en el prefijo de las tablas

WordPress usa un prefijo para las tablas de la base de datos (normalmente wp_). Si el prefijo en wp-config.php no coincide con el real, WordPress no encontrará las tablas y mostrará el error.

¿Cómo comprobarlo?

Entra en phpMyAdmin desde tu panel de hosting.
Selecciona tu base de datos.
Observa los nombres de las tablas: si empiezan por wp_, el prefijo es correcto.
Vuelve a wp-config.php y busca la línea:
```
$table_prefix = 'wp_';
```
Asegúrate de que coincide con el real.

[TIP] Algunos plugins de seguridad cambian el prefijo para protegerte. Si recientemente instalaste uno, es posible que el prefijo haya cambiado.

Paso 5: Repara la base de datos con la herramienta integrada de WordPress

WordPress incluye una herramienta de reparación de base de datos que puede resolver errores de conexión o tablas corruptas.

¿Cómo activarla?

Añade esta línea a tu archivo wp-config.php (justo antes de la línea que dice “Eso es todo, ¡diviértete!”):
```
define('WP_ALLOW_REPAIR', true);
```
Guarda el archivo.

Visita esta URL en tu navegador:

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

Haz clic en “Reparar base de datos” (o “Reparar y optimizar” si quieres hacer ambas cosas).
Cuando termine, elimina la línea que añadiste en wp-config.php para evitar accesos no autorizados.

[WARNING] No dejes la línea activa permanentemente. Es una puerta abierta para posibles atacantes.

Paso 6: Revisa los permisos de los archivos

Los permisos incorrectos en los archivos de WordPress pueden provocar errores de conexión.

¿Qué permisos deberían tener?

Carpetas: 755
Archivos: 644
wp-config.php: 600 o 640 (más restrictivo)

¿Cómo cambiarlos?

Desde el Administrador de Archivos de tu hosting, selecciona los archivos o carpetas.
Busca la opción de “Permisos” o “Chmod”.
Introduce el valor correcto y guarda.

[INFO] Si no sabes cómo hacerlo, muchos hostings tienen un botón para “restablecer permisos” en la carpeta de WordPress.

Paso 7: Comprueba el espacio en disco y los límites del servidor

Si tu base de datos ha alcanzado el límite de almacenamiento o el servidor tiene poca memoria, puede aparecer este error.

¿Cómo comprobarlo?

En tu panel de hosting, revisa el uso de disco.
Si está al 100%, libera espacio (borra copias de seguridad antiguas, logs, etc.).
También puedes aumentar el límite de memoria de WordPress editando wp-config.php:
```
define('WP_MEMORY_LIMIT', '256M');
```

[TIP] Si tu plan de hosting es muy básico, considera actualizar a uno con más recursos.

Paso 8: Revisa los logs de error

Los logs de error pueden darte pistas exactas sobre qué está fallando.

¿Dónde encontrarlos?

En cPanel o Syspanel: sección de “Errores” o “Logs”.
En el servidor: /var/log/mysql/error.log o /var/log/mysql/mysql.log.

[INFO] Si no entiendes los logs, copia las últimas 20 líneas y envíalas al soporte de tu hosting. Ellos sabrán interpretarlas.

Paso 9: Prueba con un plugin de caché o reinstala WordPress

En casos extremos, puede haber un conflicto con un plugin o un archivo corrupto.

Opción A: Desactiva todos los plugins

Accede por FTP al servidor.
Renombra la carpeta wp-content/plugins a plugins_backup.
Recarga tu web. Si funciona, el problema es un plugin.
Ve reactivando uno a uno para encontrar al culpable.

[WARNING] Si no puedes acceder a tu web por el error, hazlo por FTP o Administrador de Archivos.

Opción B: Reinstala WordPress

Descarga la última versión de WordPress desde wordpress.org.
Descomprime el archivo.
Sube por FTP solo los archivos (no la carpeta wp-content ni wp-config.php).
Sobrescribe los existentes.
Recarga tu web.

Esto repara archivos corruptos sin perder tu contenido.

Paso 10: Contacta con tu proveedor de hosting

Si has probado todo lo anterior y el error de conexión con la base de datos persiste, es hora de llamar a soporte.

Qué información debes darles:

El mensaje exacto del error.
Cuándo empezó.
Qué pasos has probado.
Tu dominio y nombre de usuario.

[TIP] Muchos hostings tienen soporte 24/7 por chat o ticket. Si usas Syspanel, recuerda que el acceso es por el puerto 2106.

Preguntas frecuentes (FAQ)

¿Por qué aparece este error después de mover mi web?

Al mover WordPress a otro servidor, es habitual olvidar actualizar las credenciales en wp-config.php. Revisa el Paso 2.

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

No. La herramienta de reparación de WordPress solo repara tablas, no borra contenido.

¿Qué hago si no tengo acceso al panel de hosting?

Si no puedes acceder al panel, contacta con soporte inmediatamente. Ellos pueden verificar el estado del servidor y las credenciales.

¿El error puede ser por un ataque hacker?

Es poco probable, pero posible. Si sospechas, cambia todas tus contraseñas (hosting, base de datos, FTP) y revisa si hay archivos extraños en tu servidor.

¿Puedo evitar este error en el futuro?

Realiza copias de seguridad periódicas.
Mantén WordPress, plugins y temas actualizados.
No modifiques wp-config.php sin saber qué haces.
Elige un hosting fiable con buen soporte.

Resumen: Lista de verificación rápida

Aquí tienes un checklist para resolver el error rápidamente:

¿Otros sitios del mismo hosting funcionan? → Si no, problema del servidor.
¿Las credenciales en wp-config.php son correctas? → Corregir si no.
¿El servicio MySQL está activo? → Iniciar o contactar soporte.
¿El prefijo de tablas coincide? → Ajustar si es necesario.
¿Has probado la herramienta de reparación? → Activar y usar.
¿Los permisos de archivos son correctos? → Ajustar a 755/644.
¿Hay espacio en disco suficiente? → Liberar si está lleno.
¿Los logs muestran algún error concreto? → Interpretar o enviar a soporte.
¿Has desactivado plugins o reinstalado WordPress? → Probar si nada funciona.
¿Has contactado con soporte? → Si todo falla, es tu mejor opción.

Conclusión

El error al establecer la conexión con la base de datos en WordPress puede ser frustrante, pero en la gran mayoría de los casos se resuelve revisando la configuración básica. Sigue los pasos en orden y, sobre todo, no te pongas nervioso: es un problema conocido y con solución.

Recuerda que, si no te sientes seguro editando archivos o accediendo a bases de datos, siempre puedes pedir ayuda a tu hosting o a un profesional. Lo importante es que tu web vuelva a estar operativa cuanto antes.

[INFO] Si tu hosting utiliza Syspanel, recuerda que el acceso al panel se realiza a través del puerto 2106. Allí encontrarás las herramientas necesarias para gestionar archivos, bases de datos y servicios.