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

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

Si estás leyendo esto, probablemente te has encontrado con un mensaje como: "Error establishing a database connection" o "Error de conexión a la base de datos". No te preocupes, es uno de los errores más comunes en WordPress y, aunque suena grave, en la mayoría de los casos tiene una solución sencilla. Este problema ocurre cuando tu sitio web no puede comunicarse con la base de datos donde se almacenan tus contenidos, configuraciones y usuarios.

En este artículo, te guiaré paso a paso para solucionar este error cuando tu sitio está alojado en un servidor con Plesk. Aprenderás a identificar la causa, verificar credenciales, revisar el archivo de configuración y usar herramientas de Plesk para restaurar la conexión. Todo explicado de forma clara y sin tecnicismos innecesarios.

[INFO] Este error no significa que hayas perdido tus datos. Solo es un problema de comunicación entre WordPress y la base de datos. Tus publicaciones, páginas y configuraciones siguen intactas.

¿Por qué ocurre el error de conexión a la base de datos en WordPress con Plesk?

Antes de lanzarnos a las soluciones, es importante entender las causas más comunes. En un entorno Plesk, las razones suelen ser:

Credenciales incorrectas: El archivo wp-config.php tiene usuario, contraseña, nombre de base de datos o servidor equivocados.
Base de datos corrupta o caída: La base de datos puede estar dañada o el servidor MySQL/MariaDB no está funcionando.
Problemas de permisos: El usuario de la base de datos no tiene los permisos adecuados.
Cambios en el servidor: Migraciones, actualizaciones de Plesk o cambios en la configuración del hosting.
Archivo wp-config.php dañado: Modificaciones manuales incorrectas o corrupción del archivo.
Límites de recursos: El servidor puede haber alcanzado su límite de conexiones simultáneas.

Paso 1: Verificar que el servidor de base de datos esté funcionando

Lo primero es asegurarnos de que el motor de base de datos (MySQL o MariaDB) esté activo en tu servidor Plesk. Si el servicio está caído, ninguna aplicación podrá conectarse.

Cómo verificarlo en Plesk:

Inicia sesión en tu panel Plesk (normalmente en https://tudominio.com:8443 o la URL que te haya proporcionado tu hosting).
Ve a Herramientas y ajustes > Servicios (o busca "Servicios del servidor").
Busca el servicio MySQL o MariaDB y verifica que esté marcado como "En ejecución" o "Running".
Si está detenido, haz clic en Iniciar.

[WARNING] Si no ves la opción de servicios, es posible que no tengas permisos de administrador del servidor. En ese caso, contacta con tu proveedor de hosting.

Alternativa rápida desde SSH (si tienes acceso):

systemctl status mysql
# o
systemctl status mariadb

Si el servicio está caído, reinícialo con:

systemctl restart mysql

Paso 2: Revisar el archivo wp-config.php

El archivo wp-config.php es el corazón de la configuración de WordPress. Contiene las credenciales de la base de datos. Un error tipográfico aquí puede romper la conexión.

Cómo acceder y editar wp-config.php desde Plesk:

En Plesk, ve a Sitios web y dominios.
Haz clic en Administrador de archivos (o Archivos).
Navega hasta la carpeta raíz de tu sitio (normalmente httpdocs o public_html).
Busca el archivo wp-config.php. Si no lo ves, activa la opción "Mostrar archivos ocultos".
Haz clic derecho sobre él y selecciona Editar.

Qué debes verificar:

Busca estas líneas (aproximadamente en la línea 20-30):

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

Errores comunes:

DB_HOST: A veces no es localhost, sino una dirección IP como 127.0.0.1 o un socket como localhost:/tmp/mysql.sock. En Plesk, normalmente es localhost.
DB_PASSWORD: Asegúrate de que no tenga espacios al inicio o final.
DB_NAME y DB_USER: Verifica que existan en Plesk (lo haremos en el siguiente paso).

[TIP] Si no recuerdas tus credenciales, puedes encontrarlas en Plesk: ve a Bases de datos dentro de tu dominio y selecciona la base de datos asociada a tu WordPress. Allí verás el nombre, usuario y podrás cambiar la contraseña.

Cómo obtener las credenciales correctas desde Plesk:

En Sitios web y dominios, haz clic en Bases de datos.
Busca la base de datos que usa tu WordPress (normalmente tiene un nombre como dominio_wp).
Haz clic en el nombre de la base de datos.
Verás el Nombre de la base de datos, Usuario y podrás Cambiar contraseña.
Copia estos datos exactamente y pégalos en wp-config.php.

Paso 3: Probar la conexión manualmente desde phpMyAdmin

Para descartar que el problema sea de WordPress, podemos intentar conectarnos directamente a la base de datos usando las credenciales que tienes.

Acceder a phpMyAdmin desde Plesk:

En Plesk, ve a Bases de datos.
Haz clic en el icono de phpMyAdmin junto a la base de datos problemática.
Se abrirá una nueva pestaña. Introduce el usuario y contraseña de la base de datos (los mismos que pusiste en wp-config.php).

Resultados posibles:

Si puedes iniciar sesión: Las credenciales son correctas. El problema está en otro lugar (archivo mal escrito, permisos, etc.).
Si no puedes iniciar sesión: Tus credenciales son incorrectas. Ve al paso 2 y actualízalas.

[INFO] Si phpMyAdmin no está instalado en tu Plesk, puedes instalarlo desde Extensiones > Catálogo de extensiones > buscar "phpMyAdmin".

Paso 4: Reparar la base de datos desde WordPress

A veces la base de datos está corrupta. WordPress tiene una herramienta de reparación integrada, pero hay que activarla manualmente.

Cómo activar el modo de reparación:

Accede a wp-config.php (como en el paso 2).
Justo antes de la línea que dice /* That's all, stop editing! Happy publishing. */, añade esta línea:

define('WP_ALLOW_REPAIR', true);

Guarda el archivo.
En tu navegador, visita: https://tudominio.com/wp-admin/maint/repair.php
Verás dos opciones: Reparar base de datos y Reparar y optimizar base de datos. Elige la segunda.
Espera a que termine. Luego elimina la línea que añadiste de wp-config.php (por seguridad).

[WARNING] No olvides eliminar la línea después de usarla. Dejarla activa es un riesgo de seguridad.

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

En Plesk, los usuarios de bases de datos tienen permisos específicos. Si por error se han eliminado, WordPress no podrá conectarse.

Cómo revisar y otorgar permisos desde Plesk:

Ve a Bases de datos > selecciona tu base de datos.
Haz clic en Usuarios.
Verás el usuario asociado. Haz clic en el icono de Editar (lápiz).
Asegúrate de que tenga marcados al menos estos permisos:
- SELECT, INSERT, UPDATE, DELETE (para operaciones normales)
- CREATE, ALTER, INDEX (para plugins y actualizaciones)
Guarda los cambios.

[TIP] Si no estás seguro, marca Todos los privilegios para evitar problemas.

Paso 6: Restaurar desde una copia de seguridad (último recurso)

Si nada funciona, es posible que la base de datos esté dañada irreversiblemente. En Plesk, puedes restaurar una copia de seguridad reciente.

Cómo restaurar en Plesk:

Ve a Sitios web y dominios > Copias de seguridad.
Busca una copia de seguridad anterior al error.
Selecciona Restaurar y elige solo Bases de datos (no sobrescribas archivos innecesariamente).
Confirma la restauración.

[WARNING] Esto sobrescribirá los datos actuales de la base de datos. Si has hecho cambios recientes, se perderán.

Preguntas frecuentes (FAQ)

¿El error de conexión puede deberse a un plugin?

Sí, aunque es raro. Algunos plugins mal codificados pueden saturar la base de datos o cambiar configuraciones. Si el error aparece después de instalar un plugin, desactívalo renombrando su carpeta desde el administrador de archivos de Plesk (cambia el nombre de wp-content/plugins/nombre-plugin a wp-content/plugins/nombre-plugin-desactivado).

¿Qué hago si no tengo acceso a Plesk?

Contacta con tu proveedor de hosting. Ellos pueden verificar el servicio MySQL y ayudarte a editar el archivo wp-config.php desde su panel.

¿El error puede ser por un ataque?

Sí, un ataque de fuerza bruta o inyección SQL puede corromper la base de datos. Si sospechas de seguridad, cambia todas las contraseñas (Plesk, FTP, base de datos) y escanea tu sitio con un plugin de seguridad como Wordfence.

¿Cómo evito este error en el futuro?

Realiza copias de seguridad periódicas (Plesk lo hace automáticamente si lo configuras).
Mantén WordPress, plugins y temas actualizados.
No modifiques wp-config.php sin hacer una copia de seguridad.
Monitorea el espacio en disco y los límites de recursos del servidor.

Conclusión

El error de conexión a la base de datos en WordPress con Plesk suele resolverse verificando el servicio MySQL, corrigiendo las credenciales en wp-config.php o reparando la base de datos. Sigue los pasos en orden y, si todo falla, recurre a una copia de seguridad. Recuerda que la paciencia y el método son tus mejores aliados.

Si después de todo esto el problema persiste, no dudes en contactar al soporte técnico de tu hosting. Ellos tienen acceso directo al servidor y pueden diagnosticar problemas más profundos.

[INFO] ¿Usas Syspanel (HestiaCP)? Recuerda que el puerto de acceso es el 2106 y el proceso es similar, aunque la interfaz cambia ligeramente. Busca la sección de bases de datos y sigue los mismos pasos.

¡Espero que este artículo te haya sido de gran ayuda! Ahora ya sabes cómo enfrentar este error con confianza.