Error de conexión a base de datos en WordPress: Soluciones FAQ | SysAdmin

¡Hola! Soy tu asistente técnico. Si estás leyendo esto, probablemente te has encontrado con el temido mensaje: "Error al establecer una conexión a la base de datos" en tu sitio WordPress. No te preocupes, es uno de los errores más comunes y, por suerte, casi siempre tiene solución. En esta FAQ (Preguntas Frecuentes) vamos a desglosar paso a paso todo lo que necesitas saber para diagnosticar y reparar este problema.

Piensa en este artículo como tu guía de primeros auxilios para el corazón de tu web: la base de datos WordPress. Vamos a empezar desde lo más básico hasta llegar a soluciones un poco más técnicas, pero siempre explicadas de forma clara y sencilla.

¿Qué significa exactamente "Error de conexión a la base de datos"?

Este mensaje significa que WordPress, el sistema que gestiona tu web, no ha podido comunicarse con el lugar donde se almacena todo tu contenido: la base de datos. Imagina que tu web es una librería y la base de datos es el almacén. Si la puerta del almacén está cerrada o la llave no funciona, no puedes vender ningún libro.

Las causas pueden ser muy variadas, desde un simple cambio de contraseña hasta un problema con el servidor. Vamos a ver las más frecuentes.

FAQ: Las 7 preguntas más comunes sobre este error

Aquí tienes las dudas más habituales que recibimos en soporte. Léelas con calma y localiza la que más se parezca a tu situación.

1. ¿He cambiado algo recientemente? (Lo primero que debes preguntarte)

[INFO] Esta es la pregunta más importante. El 90% de las veces, este error aparece justo después de que nosotros (los usuarios) tocamos algo.

¿Has hecho alguna de estas acciones?

Has cambiado la contraseña de tu base de datos desde el panel de control (como Syspanel, que es nuestro sistema de gestión, al que accedes por el puerto 2106).
Has movido tu web de un servidor a otro.
Has restaurado una copia de seguridad manualmente.
Has editado archivos importantes de WordPress (como wp-config.php).

Solución: Si respondiste "sí" a alguna de las anteriores, probablemente has encontrado la causa. Revisa que los datos que pusiste sean correctos (más abajo te explico cómo).

2. ¿Son correctos los datos de mi archivo de configuración? (wp-config.php)

Este es el archivo más importante para la conexión. Es como la tarjeta de identificación de tu web para entrar a la base de datos.

¿Cómo lo reviso?

Accede a tu panel de control de hosting. Si usas Syspanel, recuerda que la dirección es tudominio.com:2106 (cambia "tudominio.com" por tu dominio real).
Busca el administrador de archivos (suele llamarse "Gestor de Archivos" o "File Manager").
Navega hasta la carpeta donde está instalado WordPress (normalmente public_html o www).
Busca el archivo llamado wp-config.php. Haz clic derecho y selecciona "Editar".
Busca las siguientes líneas:

define('DB_NAME', 'nombre_de_tu_base_de_datos');
define('DB_USER', 'usuario_de_tu_base_de_datos');
define('DB_PASSWORD', 'contraseña_de_tu_base_de_datos');
define('DB_HOST', 'localhost');

¿Qué debes comprobar?

DB_NAME: El nombre de la base de datos debe coincidir EXACTAMENTE con el que creaste.
DB_USER: El usuario debe ser el mismo que tienes asignado.
DB_PASSWORD: Este es el error más común. Asegúrate de que la contraseña sea la correcta. Si la cambiaste recientemente, este archivo sigue teniendo la antigua.
DB_HOST: Casi siempre es localhost, pero en algunos servidores puede ser una dirección IP o un nombre como mysql.tudominio.com. Si no estás seguro, pruébalo con localhost primero.

[WARNING] Ten mucho cuidado al editar este archivo. No borres ni las comillas, ni los puntos y comas (;). Un solo carácter mal puesto puede romper la web.

3. ¿Mi base de datos está "viva"? (¿Funciona el servidor?)

A veces el problema no es tuyo, sino del servidor de bases de datos (MySQL o MariaDB). Es como si el almacén de la librería estuviera cerrado por reformas.

¿Cómo lo compruebo?

Accede a Syspanel (puerto 2106).
Busca una sección llamada "Servicios" o "Procesos".
Busca un servicio llamado MySQL, MariaDB o Database Server.
Verifica que su estado sea "Running" o "Activo". Si está "Stopped" (Detenido), significa que el servidor de bases de datos se ha apagado.

Solución: Si está detenido, normalmente hay un botón para "Iniciar" o "Reiniciar". Haz clic en él. Si no lo encuentras, contacta con tu proveedor de hosting (nosotros) y dinos que el servicio MySQL no se está ejecutando.

4. ¿Tiene la base de datos demasiada información? (Límite de tamaño)

Las bases de datos también tienen un límite de tamaño. Si tu web tiene miles de comentarios, productos o entradas, podrías haber llegado al tope.

¿Cómo lo sé?

En Syspanel, busca la sección "Bases de Datos". Verás una lista con el tamaño de cada una.
Si ves que está al 100% o muy cerca del límite de tu plan de hosting, ese es el problema.

Solución:

Opción 1 (Temporal): Optimiza la base de datos. Puedes usar un plugin como "WP-Optimize" o "Advanced Database Cleaner" para eliminar revisiones viejas, comentarios spam y borrar tablas basura.
Opción 2 (Definitiva): Contrata un plan de hosting superior que ofrezca más espacio para bases de datos.

5. ¿He movido mi web a otro servidor y no he actualizado todo?

Al migrar una web, es muy común que las direcciones (URLs) que están guardadas en la base de datos sigan apuntando al servidor antiguo, o que los datos de acceso hayan cambiado.

Solución paso a paso:

Revisa el wp-config.php: Como vimos en el punto 2, asegúrate de que el nombre de la base de datos, el usuario y la contraseña son los del NUEVO servidor.
Revisa el DB_HOST: A veces, al migrar, el host de la base de datos cambia de localhost a algo como mysql.nuevoservidor.com. Consulta la bienvenida de tu nuevo hosting para este dato.
Problema de URLs: Aunque no da el error exacto de conexión, a veces se confunde. Si la web carga pero sin estilos, es un problema de URLs, no de conexión. Para eso, necesitarás un plugin como "Better Search Replace" o editar manualmente la base de datos desde phpMyAdmin.

6. ¿Hay un plugin o tema que está causando el error?

Aunque es raro que un plugin rompa la conexión a la base de datos, puede ocurrir si un plugin de caché o seguridad guarda configuraciones incorrectas en el archivo wp-config.php.

Solución (Modo de emergencia):

Conéctate a tu web por FTP o usa el administrador de archivos de Syspanel.
Ve a la carpeta /wp-content/plugins/.
Renombra la carpeta entera a algo como plugins_old. Esto desactivará TODOS los plugins de golpe.
Recarga tu web. Si el error desaparece, el problema era un plugin.
Para identificar cuál: Ve cambiando el nombre de la carpeta de plugins_old a plugins de nuevo, y luego dentro de ella, ve renombrando las carpetas de los plugins uno por uno (añadiendo _old al final) hasta que la web se rompa de nuevo. Ese es el culpable.

7. ¿Es un ataque o malware?

En casos menos comunes, un ataque informático puede modificar el archivo wp-config.php o corromper la base de datos.

Señales de alerta:

El error aparece de repente, sin que hayas tocado nada.
Ves archivos extraños en tu servidor (con nombres como 0x0.php o shell.php).
Tu web ha sido marcada como "Phishing" o "Malware" por Google.

Solución: Si sospechas de un ataque, la mejor solución es:

Restaurar una copia de seguridad limpia de antes del problema.
Cambiar TODAS las contraseñas: La de tu hosting, la de la base de datos, la de WordPress y la del FTP.
Escanear tu web con un plugin de seguridad como Wordfence o Sucuri (después de restaurarla).

Pasos finales: ¿Qué hago si nada funciona?

Si has seguido todos los pasos anteriores y el error persiste, no te desesperes. A veces hay problemas más profundos en el servidor que requieren que nosotros, los técnicos, actuemos.

[INFO] Antes de contactarnos, ten a mano esta información para que podamos ayudarte más rápido:

Captura de pantalla del error exacto.
Los últimos cambios que hiciste en tu web (instalaste un plugin, cambiaste la contraseña, etc.).
El nombre de tu dominio y tu usuario de Syspanel (si lo recuerdas).

Resumen rápido para solucionar el error

Respira hondo. Es un error común y casi siempre reparable.
Revisa wp-config.php. Asegúrate de que el nombre, usuario y contraseña son correctos. Este es el culpable #1.
Reinicia el servicio MySQL desde Syspanel (puerto 2106).
Desactiva todos los plugins renombrando la carpeta /wp-content/plugins/.
Comprueba el espacio de tu base de datos.
Pide ayuda. Si no puedes, contacta con soporte y cuéntanos qué has probado.

Espero que esta guía FAQ te haya sido de gran ayuda. Recuerda que la base de datos es el corazón de tu WordPress, pero con un poco de paciencia y siguiendo estos pasos, podrás hacer que vuelva a latir con fuerza. ¡Mucho ánimo!