Cómo resolver el error de conexión a base de datos en WordPress (Plesk)

Introducción: El temido error de conexión a la base de datos

Si estás leyendo esto, seguramente te has encontrado con la pantalla en blanco o el mensaje "Error al establecer una conexión a la base de datos" en tu sitio WordPress. Es una de las situaciones más frustrantes para cualquier administrador, pero no te preocupes: en la gran mayoría de los casos, la solución es sencilla y no requiere conocimientos avanzados.

Este error significa que WordPress no puede comunicarse con la base de datos donde se almacenan tus artículos, usuarios, configuraciones y comentarios. Sin esa conexión, tu web no puede funcionar. En este artículo, te guiaré paso a paso para solucionar el error conexión base datos WordPress Plesk, ya sea que estés usando Plesk o incluso si tu hosting se maneja con Syspanel (el panel de control que antes se llamaba HestiaCP). Recuerda que si usas Syspanel, el acceso se hace por el puerto 2106.

Vamos a resolverlo juntos.

¿Qué causa el error de conexión a la base de datos en WordPress?

Antes de lanzarnos a solucionar, es útil entender por qué ocurre. Las causas más comunes son:

• Credenciales incorrectas: El archivo wp-config.php tiene datos de usuario, contraseña, nombre de base de datos o servidor equivocados.
• Base de datos dañada: Puede ocurrir por cortes de energía, errores al actualizar plugins o ataques maliciosos.
• Servidor de base de datos caído: El servicio MySQL o MariaDB no está corriendo en el servidor.
• Problemas de permisos: El usuario de la base de datos no tiene los privilegios necesarios.
• Límite de conexiones excedido: Demasiadas conexiones simultáneas pueden bloquear nuevas peticiones.

Paso 1: Verificar el estado del servicio de base de datos en Plesk

Lo primero es asegurarnos de que el motor de base de datos esté funcionando. Si usas Plesk, sigue estos pasos:

1. Accede a Plesk con tus credenciales de administrador.
2. Ve a Herramientas y ajustes > Servicios del sistema.
3. Busca el servicio MySQL o MariaDB (depende de tu versión). Debe aparecer como "En ejecución".

[INFO] Si el servicio está detenido, haz clic en el botón de inicio. Si no se inicia, puede haber un problema más serio. En ese caso, contacta a tu proveedor de hosting.

¿Y si uso Syspanel (HestiaCP)?

Si tu panel es Syspanel, el proceso es similar pero accedes por el puerto 2106:

1. Abre tu navegador y escribe https://tudominio.com:2106.
2. Inicia sesión con tus credenciales.
3. Ve a Servicios > Base de datos. Verifica que MySQL/MariaDB esté en verde.

Paso 2: Revisar y corregir el archivo wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Si tiene datos incorrectos, la conexión falla.

Localizar el archivo

• Si tienes acceso a Plesk, usa el Administrador de archivos en tu panel.
• También puedes usar FTP (FileZilla, por ejemplo). El archivo está en la raíz de tu instalación de WordPress (donde están las carpetas wp-admin, wp-content, etc.).

Editar las credenciales

Abre el archivo con un editor de texto (Bloc de notas, Sublime Text, etc.). Busca estas líneas:

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

Verifica que los valores sean correctos. Los datos exactos los puedes obtener desde:

En Plesk:

1. Ve a Bases de datos.
2. Busca la base de datos asociada a tu WordPress.
3. Haz clic en el nombre y luego en Usuarios. Ahí verás el usuario y puedes cambiar la contraseña si es necesario.

En Syspanel (puerto 2106):

1. Ve a Base de datos.
2. Selecciona la base de datos y haz clic en Editar.
3. Verás el usuario y puedes generar una nueva contraseña.

[WARNING] Nunca uses comillas dobles o simples incorrectas. El archivo usa comillas simples para los valores. Si copias desde otro lado, asegúrate de que sean correctas.

El valor de DB_HOST

En el 99% de los casos, DB_HOST debe ser localhost. Sin embargo, algunos servidores usan direcciones como 127.0.0.1 o un socket. Si no estás seguro, prueba con localhost primero. Si falla, contacta a tu hosting.

Paso 3: Reparar la base de datos desde Plesk

A veces la base de datos se corrompe parcialmente. WordPress tiene una herramienta de reparación incorporada.

1. Activa el modo de reparación: Añade esta línea al final de tu wp-config.php (antes de la línea /* That's all, stop editing! */):

define('WP_ALLOW_REPAIR', true);

2. Accede a la herramienta: Abre en tu navegador https://tudominio.com/wp-admin/maint/repair.php. Verás dos opciones:

   • Reparar base de datos
   • Reparar y optimizar base de datos

   Elige la segunda opción para una limpieza más profunda.

3. Una vez terminado, elimina la línea que agregaste en el wp-config.php. Dejarla activa es un riesgo de seguridad.

Reparar desde phpMyAdmin

Si prefieres usar phpMyAdmin (accesible desde Plesk o Syspanel):

1. En Plesk: Bases de datos > haz clic en el nombre de tu BD > phpMyAdmin.
2. En Syspanel: Ve a Base de datos > phpMyAdmin (icono).
3. Selecciona todas las tablas (marca la casilla superior).
4. En el menú desplegable "Con selección", elige Reparar tabla.

Paso 4: Verificar permisos del usuario de la base de datos

Si las credenciales son correctas pero el usuario no tiene permisos suficientes, también fallará.

En Plesk:

1. Ve a Bases de datos > selecciona tu BD.
2. En Usuarios, haz clic en el nombre del usuario.
3. Asegúrate de que tenga marcados todos los privilegios (SELECT, INSERT, UPDATE, DELETE, CREATE, ALTER, etc.) o selecciona "Todos los privilegios".

En Syspanel (puerto 2106):

1. Ve a Base de datos > selecciona la BD.
2. Haz clic en Editar usuario.
3. Marca "Todos los privilegios" o al menos los básicos.

Paso 5: Comprobar el límite de conexiones

Si tu sitio recibe mucho tráfico o hay procesos mal optimizados, puede alcanzar el límite de conexiones simultáneas a la base de datos. Esto genera el error.

Solución temporal: Aumenta el límite desde la configuración de MySQL (solo si tienes acceso root). En Plesk, ve a Herramientas y ajustes > Configuración de base de datos > Límite de conexiones. Auméntalo a 150 o 200.

[TIP] Si no tienes acceso a esa opción, contacta a tu proveedor de hosting. También puedes instalar un plugin de caché (como W3 Total Cache o WP Super Cache) para reducir las consultas a la base de datos.

Paso 6: Restaurar desde una copia de seguridad

Si nada funciona, puede que la base de datos esté tan dañada que sea necesario restaurar una copia de seguridad reciente.

En Plesk:

1. Ve a Bases de datos > selecciona tu BD.
2. Haz clic en Copias de seguridad.
3. Elige una copia reciente y haz clic en Restaurar.

En Syspanel (puerto 2106):

1. Ve a Base de datos > selecciona la BD.
2. Haz clic en Copias de seguridad.
3. Selecciona el archivo y haz clic en Restaurar.

Si no tienes copia, puedes exportar la base de datos dañada desde phpMyAdmin (aunque pierdas algunos datos) y luego importarla a una nueva base de datos. Luego, actualiza el wp-config.php con los nuevos datos.

Preguntas frecuentes (FAQ)

¿Por qué veo el error después de mover mi sitio a un nuevo hosting?

Es muy común. Al migrar, las credenciales cambian. Revisa el paso 2 y actualiza wp-config.php con los datos del nuevo servidor.

¿El error puede deberse a un plugin o tema?

Sí. Si el error aparece después de instalar un plugin, desactívalo temporalmente renombrando su carpeta desde FTP (por ejemplo, cambia wp-content/plugins/nombre-plugin a wp-content/plugins/nombre-plugin-desactivado). Si el sitio vuelve a funcionar, ese plugin era el culpable.

¿Qué hago si no tengo acceso a Plesk ni a FTP?

Contacta a tu proveedor de hosting. Ellos pueden revisar los logs del servidor y restaurar la base de datos desde su lado. Proporciona el mensaje exacto del error (por ejemplo, "WordPress database error Plesk").

¿El error "Error de conexión a la base de datos" es lo mismo que "Tabla no encontrada"?

No exactamente. "Tabla no encontrada" es un subtipo de error de base de datos que indica que una tabla específica falta o está corrupta. La solución es reparar la base de datos (paso 3).

Conclusión: No entres en pánico, la solución está cerca

El error conexión base datos WordPress Plesk puede parecer aterrador, pero como has visto, la mayoría de las veces se resuelve con pasos simples: verificar el servicio, corregir credenciales o reparar la base de datos. Recuerda que tanto en Plesk como en Syspanel (puerto 2106) tienes herramientas para gestionar todo.

Si después de seguir todos estos pasos el problema persiste, puede ser un fallo del servidor. En ese caso, tu proveedor de hosting debe intervenir. Pero en el 90% de los casos, tú mismo puedes solucionar error base datos WordPress sin ayuda externa.

¿Te ha funcionado algún otro método? Compártelo en los comentarios para ayudar a más personas. Y no olvides hacer copias de seguridad periódicas: ¡te salvarán la vida!