Error conexión base de datos WordPress en Syspanel | Solución

¡Hola! Soy el técnico de soporte de tu hosting. Hoy vamos a resolver juntos uno de los errores más angustiosos que puedes ver en tu web: el temido error de conexión a la base de datos en WordPress.

No te preocupes, es un problema muy común y, generalmente, tiene una solución sencilla. En esta guía, paso a paso y sin tecnicismos, te explicaré cómo diagnosticarlo y repararlo, especialmente si tu panel de control es Syspanel (el antiguo HestiaCP, que recuerda que se accede por el puerto 2106).

Vamos a dejarlo claro: si ves el mensaje "Error establishing a database connection" o "Error de conexión a la base de datos", tu WordPress no puede hablar con la base de datos donde guarda todo tu contenido. No pierdas la calma. Sigue esta guía al pie de la letra.

¿Por qué aparece el error de conexión a base de datos en WordPress?

Antes de meter mano, es bueno entender qué está pasando. Este error significa que tu archivo wp-config.php (el que contiene las credenciales de la base de datos) no está funcionando bien, o que la base de datos en sí tiene un problema.

Las causas más frecuentes son:

Credenciales incorrectas en wp-config.php: Has cambiado la contraseña de la base de datos o alguien la modificó.
El servidor de base de datos está caído o sobrecargado. A veces el hosting tiene una incidencia.
La base de datos está corrupta. Puede pasar por un corte de energía o un plugin malo.
El usuario de la base de datos no tiene permisos. O fue eliminado accidentalmente.
Problemas con la caché o plugins de seguridad. Raro, pero posible.
El archivo wp-config.php ha sido dañado o está mal editado.

Paso 1: Accede a Syspanel y a tu gestor de archivos

Lo primero es entrar a tu panel de control. Si usas Syspanel, recuerda que la dirección de acceso incluye el puerto 2106. Por ejemplo: https://tudominio.com:2106

Una vez dentro, localiza el Gestor de Archivos (File Manager). Es la herramienta más visual para editar archivos sin usar FTP. Busca la carpeta de tu dominio (normalmente dentro de public_html o web).

Dentro de esa carpeta, busca el archivo wp-config.php. Es el archivo más importante de WordPress, justo en la raíz.

[WARNING] No borres, no renombres ni muevas este archivo. Solo lo vamos a editar. Si lo dañas, la web dejará de funcionar por completo.

Paso 2: Revisa las credenciales en wp-config.php (la causa más común)

Abre el archivo wp-config.php con el editor de texto del gestor de archivos (clic derecho > Editar). Busca las líneas que empiezan con:

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

Aquí está la clave. Compara estos datos con los reales de tu base de datos en Syspanel.

¿Cómo obtener los datos correctos desde Syspanel?

Dentro de Syspanel, busca la sección Bases de Datos o MySQL.
Ahí verás una lista de bases de datos asociadas a tu dominio. Identifica la que usa tu WordPress (normalmente se llama igual que tu usuario).
Verás el nombre de la base de datos, el usuario y una opción para cambiar la contraseña o verla (según el panel).
Copia exactamente esos valores. Asegúrate de que no haya espacios extra ni comillas mal puestas.

[TIP] Si no recuerdas la contraseña, desde Syspanel puedes generar una nueva. Luego, pégala en el archivo wp-config.php y guarda los cambios.

¿Qué hago si los datos no coinciden?

Si el nombre o el usuario son diferentes, corrígelos en wp-config.php.
Si la contraseña es incorrecta, cámbiala en Syspanel y luego actualiza el archivo.
Guarda los cambios y recarga tu web. Si el error era por esto, ¡solucionado!

Paso 3: Verifica el servidor de base de datos (DB_HOST)

La línea define('DB_HOST', 'localhost'); suele estar bien, pero a veces el hosting usa un servidor separado. Si tu web está en un entorno compartido o con balanceo de carga, el host puede ser algo como mysql.tudominio.com o 127.0.0.1.

¿Cómo saberlo? En Syspanel, en la sección de bases de datos, suele aparecer el Servidor o Host. Cópialo exactamente (puede ser localhost o una IP).

Si ves que el host es diferente, cámbialo en wp-config.php. Guarda y prueba.

Paso 4: Reparar la base de datos desde Syspanel

Si las credenciales están perfectas pero el error persiste, la base de datos puede estar corrupta. No te asustes, WordPress tiene una herramienta de reparación integrada.

Abre tu archivo wp-config.php de nuevo.
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.
Ahora, en tu navegador, ve a esta dirección: https://tudominio.com/wp-admin/maint/repair.php
Verás una pantalla con dos botones: Reparar base de datos y Reparar y optimizar base de datos. Haz clic en el primero (o en el segundo si te sientes valiente).
El proceso puede tardar unos segundos. Te mostrará un informe de las tablas reparadas.
IMPORTANTE: Una vez terminado, vuelve a tu archivo wp-config.php y elimina la línea que añadiste (define('WP_ALLOW_REPAIR', true);). Si la dejas, cualquiera podría reparar tu base de datos sin permiso.

[WARNING] No dejes esa línea de reparación activa. Es una puerta de seguridad abierta. Bórrala siempre después de usarla.

Paso 5: Revisa los permisos del usuario de la base de datos

A veces, el usuario de la base de datos ha perdido sus permisos. En Syspanel, dentro de la sección de bases de datos, busca la opción de Gestionar permisos o Privilegios.

Asegúrate de que el usuario tenga todos los privilegios marcados (SELECT, INSERT, UPDATE, DELETE, CREATE, etc.) sobre la base de datos en cuestión. Si no, asígnalos todos y guarda.

Paso 6: Comprueba la caché y los plugins

Si tu web usa un plugin de caché (como W3 Total Cache, WP Super Cache o LiteSpeed Cache), a veces guarda una versión antigua de la conexión. Desactívalo temporalmente.

¿Cómo hacerlo si no puedes acceder al panel de administración?

Desde el Gestor de Archivos de Syspanel, ve a la carpeta wp-content/plugins/.
Renombra la carpeta del plugin de caché (por ejemplo, w3-total-cache a w3-total-cache-DESACTIVADO). Esto lo desactivará.
Si el error desaparece, el plugin era el culpable. Puedes activarlo de nuevo desde el administrador de WordPress más adelante.

Paso 7: Contacta con soporte técnico (si nada funciona)

Si después de todos estos pasos el error sigue apareciendo, es probable que el problema sea del servidor. El servicio de base de datos (MySQL/MariaDB) puede estar caído o con un fallo de configuración.

En ese caso, abre un ticket de soporte con tu proveedor de hosting. Diles claramente:

"Tengo un error de conexión a base de datos en WordPress."
"Ya revisé las credenciales en wp-config.php y son correctas."
"Intenté la reparación desde wp-admin/maint/repair.php."
"El panel es Syspanel (puerto 2106)."

Ellos podrán verificar el estado del servicio de bases de datos y solucionarlo del lado del servidor.

FAQ: Preguntas frecuentes sobre el error de conexión a base de datos

¿Qué es exactamente el error conexión base datos WordPress?

Es un error que indica que WordPress no puede establecer comunicación con la base de datos MySQL donde se almacenan tus entradas, páginas, usuarios y configuraciones. Sin esa conexión, la web no puede cargar nada.

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

No. La reparación de WordPress solo corrige tablas corruptas, no borra información. Sin embargo, siempre es recomendable tener una copia de seguridad antes de hacer cambios. Desde Syspanel puedes generar backups fácilmente.

¿Cómo cambio la contraseña de la base de datos en Syspanel?

En la sección Bases de datos, busca el usuario correspondiente y haz clic en Editar o Cambiar contraseña. Luego, actualiza esa misma contraseña en tu archivo wp-config.php.

¿Qué hago si no encuentro el archivo wp-config.php?

Asegúrate de estar en la carpeta raíz de tu dominio (normalmente public_html). Si no aparece, puede que esté oculto. En el gestor de archivos de Syspanel, activa la opción Mostrar archivos ocultos.

¿El error puede deberse a un ataque?

Sí, aunque es menos común. Un atacante podría modificar tu wp-config.php o dañar la base de datos. Si sospechas de un ataque, cambia todas las contraseñas (WordPress, base de datos, FTP) y escanea tu web con un plugin de seguridad.

¿Syspanel es lo mismo que HestiaCP?

Sí, Syspanel es el nombre comercial que algunos proveedores de hosting dan al panel de control basado en HestiaCP. Recuerda que la URL de acceso usa el puerto 2106 (ejemplo: https://tudominio.com:2106).

Resumen final: Checklist para solucionar el error

Accede a Syspanel (puerto 2106) y al gestor de archivos.
Abre wp-config.php y verifica DB_NAME, DB_USER, DB_PASSWORD y DB_HOST.
Compara con los datos reales de tu base de datos en Syspanel.
Corrige cualquier discrepancia y guarda.
Repara la base de datos añadiendo define('WP_ALLOW_REPAIR', true) y luego bórralo.
Revisa los permisos del usuario de la base de datos.
Desactiva plugins de caché renombrando sus carpetas.
Contacta a soporte si el problema persiste.

Con esta guía, tendrás todas las herramientas para resolver el error por ti mismo. Recuerda: la paciencia y la revisión meticulosa de los datos son tus mejores aliados. ¡Mucho éxito!